Merge branch 'main' into global-focus-varsglobal-focus-vars

1 files changed, 30 insertions, 0 deletions

diff --git a/site/content/docs/5.1/utilities/shadows.md b/site/content/docs/5.1/utilities/shadows.md
new file mode 100644
index 000000000..bb5ef44ab
--- /dev/null
+++ b/site/content/docs/5.1/utilities/shadows.md
@@ -0,0 +1,30 @@
+---
+layout: docs
+title: Shadows
+description: Add or remove shadows to elements with box-shadow utilities.
+group: utilities
+toc: true
+---
+
+## Examples
+
+While shadows on components are disabled by default in Bootstrap and can be enabled via `$enable-shadows`, you can also quickly add or remove a shadow with our `box-shadow` utility classes. Includes support for `.shadow-none` and three default sizes (which have associated variables to match).
+
+{{< example >}}
+<div class="shadow-none p-3 mb-5 bg-light rounded">No shadow</div>
+<div class="shadow-sm p-3 mb-5 bg-body rounded">Small shadow</div>
+<div class="shadow p-3 mb-5 bg-body rounded">Regular shadow</div>
+<div class="shadow-lg p-3 mb-5 bg-body rounded">Larger shadow</div>
+{{< /example >}}
+
+## Sass
+
+### Variables
+
+{{< scss-docs name="box-shadow-variables" file="scss/_variables.scss" >}}
+
+### Utilities API
+
+Shadow utilities are declared in our utilities API in `scss/_utilities.scss`. [Learn how to use the utilities API.]({{< docsref "/utilities/api#using-the-api" >}})
+
+{{< scss-docs name="utils-shadow" file="scss/_utilities.scss" >}}