diff --git a/website/docusaurus.config.js b/website/docusaurus.config.js
index a7931b746..f286b3e65 100644
--- a/website/docusaurus.config.js
+++ b/website/docusaurus.config.js
@@ -96,6 +96,7 @@ module.exports = {
                 'important',
                 'caution',
                 'impact',
+                'deprecated'
             ],
         },
         },
@@ -114,6 +115,7 @@ module.exports = {
                 'important',
                 'caution',
                 'impact',
+                'deprecated'
             ],
         },
         },
diff --git a/website/src/theme/Admonition/index.js b/website/src/theme/Admonition/index.js
index 8ddb8189c..37ad748e7 100644
--- a/website/src/theme/Admonition/index.js
+++ b/website/src/theme/Admonition/index.js
@@ -61,6 +61,28 @@ function ImpactIcon() {
     </svg>
     )    
 }
+
+function DeprecatedIcon() {
+  return (
+  <svg
+    width="800px"
+    height="800px"
+    viewBox="0 0 16 16"
+    xmlns="http://www.w3.org/2000/svg"
+    xmlnsXlink="http://www.w3.org/1999/xlink"
+  >
+    <path
+      fill="#444"
+      d="M4 2c0-1.1-0.9-2-2-2s-2 0.9-2 2c0 0.7 0.4 1.4 1 1.7v12.3h2v-12.3c0.6-0.3 1-1 1-1.7z"
+    />
+    <path
+      fill="#444"
+      d="M4 4c0 0 1-3 3.6-3 2.7 0 2.3 1 4.4 1 2.4 0 4-1 4-1v8c0 0-0.7 2-4 2-2.2 0-2.3-1-5-1-2.3 0-3 2-3 2v-8z"
+    />
+  </svg>
+    )    
+}
+
 // eslint-disable-next-line @typescript-eslint/consistent-indexed-object-style
 const AdmonitionConfigs = {
   note: {
@@ -129,6 +151,17 @@ const AdmonitionConfigs = {
       </Translate>
     ),
   },
+  deprecated: {
+    infimaClassName: 'deprecated',
+    iconComponent: DeprecatedIcon,
+    label: (
+      <Translate
+        id="theme.admonition.impact"
+        description="The default label used for the Deprecated admonition (:::deprecated)">
+        Deprecated
+      </Translate>
+    ),
+  },
 };
 // Legacy aliases, undocumented but kept for retro-compatibility
 const aliases = {
diff --git a/website/static/css/custom.css b/website/static/css/custom.css
index 22a637c08..f7d0b91cd 100644
--- a/website/static/css/custom.css
+++ b/website/static/css/custom.css
@@ -232,6 +232,12 @@ body {
     --ifm-alert-foreground-color: rgb(66,69,73);
     --ifm-alert-border-color: #FF6121;
   }
+.alert--deprecated {
+    --ifm-alert-background-color: var(--ifm-color-danger-contrast-background);
+    --ifm-alert-background-color-highlight: rgba(250, 56, 62, 0.15);
+    --ifm-alert-foreground-color: var(--ifm-color-danger-contrast-foreground);
+    --ifm-alert-border-color: var(--ifm-color-danger-dark);
+}
 .button.button--secondary {
     color: var(--wm-secondary-text-color);
     background-color:var(--wm-secondary-bg-color);