diff --git a/site/source/docs/tools_reference/settings_reference.rst b/site/source/docs/tools_reference/settings_reference.rst
index 8f2dbad9928a1..de87804636bcf 100644
--- a/site/source/docs/tools_reference/settings_reference.rst
+++ b/site/source/docs/tools_reference/settings_reference.rst
@@ -563,6 +563,8 @@ You can set 'subprotocol' to null, if you don't want to specify it.
 Run time configuration may be useful as it lets an application select
 multiple different services.
 
+.. note:: This setting is deprecated
+
 Default value: false
 
 .. _websocket_url:
@@ -3542,6 +3544,7 @@ these settings please open a bug (or reply to one of the existing bugs).
  - ``DETERMINISTIC``: under consideration for removal (https://github.com/emscripten-core/emscripten/issues/26647)
  - ``USE_PTHREADS``: prefer the standard -pthread flag
  - ``MEMORY64``: prefer the standard -m64 or --target=wasm64 flags
+ - ``SOCKET_WEBRTC``: under consideration for removal (https://github.com/emscripten-core/emscripten/issues/27366)
 
 .. _legacy-settings:
 
diff --git a/src/settings.js b/src/settings.js
index 257b091c5f5c2..35c77f89e0f25 100644
--- a/src/settings.js
+++ b/src/settings.js
@@ -404,6 +404,7 @@ var FS_DEBUG = false;
 // Run time configuration may be useful as it lets an application select
 // multiple different services.
 // [link]
+// [deprecated]
 var SOCKET_WEBRTC = false;
 
 // A string containing either a WebSocket URL prefix (ws:// or wss://) or a
diff --git a/tools/settings.py b/tools/settings.py
index 8b75d5cd5bb09..06fb37d704df7 100644
--- a/tools/settings.py
+++ b/tools/settings.py
@@ -117,6 +117,7 @@
     'DETERMINISTIC': 'under consideration for removal (https://github.com/emscripten-core/emscripten/issues/26647)',
     'USE_PTHREADS': 'prefer the standard -pthread flag',
     'MEMORY64': 'prefer the standard -m64 or --target=wasm64 flags',
+    'SOCKET_WEBRTC': 'under consideration for removal (https://github.com/emscripten-core/emscripten/issues/27366)',
 }
 
 # Settings that don't need to be externalized when serializing to json because they