diff --git a/docs/assets/scss/docs.scss b/docs/assets/scss/docs.scss
index a3ae687e9a..fb8ac95ef7 100644
--- a/docs/assets/scss/docs.scss
+++ b/docs/assets/scss/docs.scss
@@ -23,7 +23,7 @@
 @import "bootstrap/breadcrumb";
 // @import "bootstrap/pagination";
 // @import "bootstrap/badge";
-// @import "bootstrap/alert";
+@import "bootstrap/alert";
 // @import "bootstrap/progress";
 // @import "bootstrap/list-group";
 @import "bootstrap/close";
diff --git a/docs/content/icons/~deprecated.md b/docs/content/icons/~deprecated.md
new file mode 100644
index 0000000000..da707bd28b
--- /dev/null
+++ b/docs/content/icons/~deprecated.md
@@ -0,0 +1,11 @@
+---
+# TODO XXX
+# PREVIEW FILE -- REMOVE BEFORE RELEASE
+title: Deprecated Example
+categories:
+  - Files and folders
+tags:
+  - box
+  - delete
+deprecated: true
+---
diff --git a/docs/layouts/icons/single.html b/docs/layouts/icons/single.html
index 0d791da886..40facd2025 100644
--- a/docs/layouts/icons/single.html
+++ b/docs/layouts/icons/single.html
@@ -31,6 +31,12 @@ <h1>{{ .Title }}</h1>
         </div>
       </div>
 
+      {{ if .Params.deprecated -}}
+        <div class="alert alert-danger my-3" role="alert">
+          <strong>Deprecation notice:</strong> This icon is deprecated and will be removed in an upcoming version!
+        </div>
+      {{- end }}
+
       <hr class="my-4">
 
       {{- $localSvgPath := printf "/icons/%s.svg" .File.TranslationBaseName -}}
diff --git a/docs/layouts/partials/icons.html b/docs/layouts/partials/icons.html
index b9c9b26ac8..8064d81a1d 100644
--- a/docs/layouts/partials/icons.html
+++ b/docs/layouts/partials/icons.html
@@ -10,20 +10,22 @@ <h2 id="icons" class="mb-0">Icons</h2>
     {{ range (where .Site.RegularPages "Type" "icons") -}}
       {{- $filename := .File.TranslationBaseName -}}
       {{- with .Site.GetPage .File.Path }}
-      <li class="col mb-4"{{ with .Params.tags }} data-tags="{{ delimit . " " }}"{{ end }}{{ with .Params.categories }} data-categories="{{ delimit . " " | lower }}"{{ end }}>
-        <a class="d-block text-body-emphasis text-decoration-none" href="{{ .RelPermalink }}">
-          <div class="px-3 py-4 mb-2 bg-body-secondary text-center rounded">
-            {{ if $.IsHome -}}
-            <i class="bi bi-{{ $filename }}"></i>
-            {{- else -}}
-            <svg class="bi" width="1em" height="1em" fill="currentColor">
-              <use xlink:href="../bootstrap-icons.svg#{{ $filename }}"/>
-            </svg>
-            {{- end }}
-          </div>
-          <div class="name text-muted text-decoration-none text-center pt-1">{{ $filename }}</div>
-        </a>
-      </li>
+        {{- if not (.Params.deprecated) }}
+          <li class="col mb-4"{{ with .Params.tags }} data-tags="{{ delimit . " " }}"{{ end }}{{ with .Params.categories }} data-categories="{{ delimit . " " | lower }}"{{ end }}>
+            <a class="d-block text-body-emphasis text-decoration-none" href="{{ .RelPermalink }}">
+              <div class="px-3 py-4 mb-2 bg-body-secondary text-center rounded">
+                {{ if $.IsHome -}}
+                  <i class="bi bi-{{ $filename }}"></i>
+                {{- else -}}
+                <svg class="bi" width="1em" height="1em" fill="currentColor">
+                  <use xlink:href="../bootstrap-icons.svg#{{ $filename }}"/>
+                </svg>
+                {{- end }}
+              </div>
+              <div class="name text-muted text-decoration-none text-center pt-1">{{ $filename }}</div>
+            </a>
+          </li>
+        {{- end }}
       {{- end }}
     {{- end }}
   </ul>