diff --git a/docs/plugins/gst_plugins_cache.json b/docs/plugins/gst_plugins_cache.json
index 145f9225e4..15d983e866 100644
--- a/docs/plugins/gst_plugins_cache.json
+++ b/docs/plugins/gst_plugins_cache.json
@@ -11351,7 +11351,7 @@
                         "value": "0x00000800"
                     },
                     {
-                        "desc": "Force only software-based decoders",
+                        "desc": "Force only software-based decoders (no effect for playbin3)",
                         "name": "force-sw-decoders",
                         "value": "0x00001000"
                     }
diff --git a/gst/playback/gstplay-enum.c b/gst/playback/gstplay-enum.c
index fce8f6f05c..c1b666d608 100644
--- a/gst/playback/gstplay-enum.c
+++ b/gst/playback/gstplay-enum.c
@@ -70,7 +70,8 @@ gst_play_flags_get_type (void)
     {C_FLAGS (GST_PLAY_FLAG_FORCE_FILTERS),
         "Force audio/video filter(s) to be applied", "force-filters"},
     {C_FLAGS (GST_PLAY_FLAG_FORCE_SW_DECODERS),
-        "Force only software-based decoders", "force-sw-decoders"},
+          "Force only software-based decoders (no effect for playbin3)",
+        "force-sw-decoders"},
     {0, NULL, NULL}
   };
   static volatile GType id = 0;