diff --git a/package.json b/package.json
index 9803265bfb..2d4db82ec1 100644
--- a/package.json
+++ b/package.json
@@ -2027,12 +2027,14 @@
                 "docker.attachShellCommand.linuxContainer": {
                     "type": "string",
                     "default": "/bin/sh -c \"[ -e /bin/bash ] && /bin/bash || /bin/sh\"",
-                    "description": "%vscode-docker.config.docker.attachShellCommand.linuxContainer%"
+                    "description": "%vscode-docker.config.docker.attachShellCommand.linuxContainer%",
+                    "deprecationMessage": "%vscode-docker.config.deprecated%"
                 },
                 "docker.attachShellCommand.windowsContainer": {
                     "type": "string",
                     "default": "cmd",
-                    "description": "%vscode-docker.config.docker.attachShellCommand.windowsContainer%"
+                    "description": "%vscode-docker.config.docker.attachShellCommand.windowsContainer%",
+                    "deprecationMessage": "%vscode-docker.config.deprecated%"
                 },
                 "docker.dockerComposeBuild": {
                     "type": "boolean",
diff --git a/package.nls.json b/package.nls.json
index 6b18a90891..40203c12ae 100644
--- a/package.nls.json
+++ b/package.nls.json
@@ -168,6 +168,7 @@
     "vscode-docker.config.docker.dockerComposeBuild": "Set to true to include --build option when docker-compose command is invoked",
     "vscode-docker.config.docker.dockerComposeDetached": "Set to true to include --d (detached) option when docker-compose command is invoked",
     "vscode-docker.config.docker.showRemoteWorkspaceWarning": "Set to true to prompt to switch from \"UI\" extension mode to \"Workspace\" extension mode if an operation is not supported in UI mode.",
+    "vscode-docker.config.deprecated": "This setting has been deprecated and will be removed in a future release.",
     "vscode-docker.commands.api.configure": "Add Docker Files to Workspace (API)...",
     "vscode-docker.commands.compose.down": "Compose Down",
     "vscode-docker.commands.compose.restart": "Compose Restart",