diff --git a/DOCS/interface-changes.rst b/DOCS/interface-changes.rst
index fc91db404c..28967bb12b 100644
--- a/DOCS/interface-changes.rst
+++ b/DOCS/interface-changes.rst
@@ -92,6 +92,7 @@ Interface changes
     - rename `--cdrom-device` to `--cdda-device`
     - remove `--scale-cutoff`, `--cscale-cutoff`, `--dscale-cutoff`, `--tscale-cutoff`
     - remove `--scaler-lut-size`
+    - deprecate shared-script-properties (user-data is a replacement)
  --- mpv 0.36.0 ---
     - add `--target-contrast`
     - Target luminance value is now also applied when ICC profile is used.
diff --git a/player/command.c b/player/command.c
index 489dfaa6f1..c09a8aaf6a 100644
--- a/player/command.c
+++ b/player/command.c
@@ -3617,6 +3617,8 @@ static int mp_property_script_props(void *ctx, struct m_property *prop,
 {
     MPContext *mpctx = ctx;
     struct command_ctx *cmd = mpctx->command_ctx;
+    MP_WARN(mpctx, "The shared-script-properties property is deprecated and will "
+            "be removed in the future. Use the user-data property instead.\n");
     switch (action) {
     case M_PROPERTY_GET_TYPE:
         *(struct m_option *)arg = script_props_type;