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/opacity.md b/site/content/docs/5.1/utilities/opacity.md
new file mode 100644
index 000000000..a2fdc3807
--- /dev/null
+++ b/site/content/docs/5.1/utilities/opacity.md
@@ -0,0 +1,30 @@
+---
+layout: docs
+title: Opacity
+description: Control the opacity of elements.
+group: utilities
+---
+
+The `opacity` property sets the opacity level for an element. The opacity level describes the transparency level, where `1` is not transparent at all, `.5` is 50% visible, and `0` is completely transparent.
+
+Set the `opacity` of an element using `.opacity-{value}` utilities.
+
+<div class="bd-example d-sm-flex">
+  <div class="opacity-100 p-3 m-2 bg-primary text-light fw-bold rounded">100%</div>
+  <div class="opacity-75 p-3 m-2 bg-primary text-light fw-bold rounded">75%</div>
+  <div class="opacity-50 p-3 m-2 bg-primary text-light fw-bold rounded">50%</div>
+  <div class="opacity-25 p-3 m-2 bg-primary text-light fw-bold rounded">25%</div>
+</div>
+
+```html
+<div class="opacity-100">...</div>
+<div class="opacity-75">...</div>
+<div class="opacity-50">...</div>
+<div class="opacity-25">...</div>
+```
+
+### Utilities API
+
+Opacity 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-opacity" file="scss/_utilities.scss" >}}