diff --git a/site/content/docs/5.0/components/alerts.md b/site/content/docs/5.0/components/alerts.md
index 3ef2e62cf8bd..42853f2e0ca4 100644
--- a/site/content/docs/5.0/components/alerts.md
+++ b/site/content/docs/5.0/components/alerts.md
@@ -49,6 +49,62 @@ Alerts can also contain additional HTML elements like headings, paragraphs and d
{{< /example >}}
+### Icons
+
+Similarly, you can use [flexbox utilities]({{< docsref "/utilities/flex" >}}) and [Bootstrap Icons]({{ .Site.Params.icons }}) to create alerts with icons. Depending on your icons and content, you may want to add more utilities or custom styles.
+
+{{< example >}}
+
+
+
+ An example alert with an icon
+
+
+{{< /example >}}
+
+Need more than one icon for your alerts? Consider using more Bootstrap Icons and making a local SVG sprite like so to easily reference the same icons repeatedly.
+
+{{< example >}}
+
+
+
+
+
+ An example alert with an icon
+
+
+
+
+
+ An example success alert with an icon
+
+
+
+
+
+ An example warning alert with an icon
+
+
+
+
+
+ An example danger alert with an icon
+
+
+{{< /example >}}
+
### Dismissing
Using the alert JavaScript plugin, it's possible to dismiss any alert inline. Here's how: