Allow to add more embed responsive ratios (#25894)

1 files changed, 12 insertions, 1 deletions

diff --git a/site/docs/4.1/utilities/embed.md b/site/docs/4.1/utilities/embed.md
index 4713c598c..de4105fb8 100644
--- a/site/docs/4.1/utilities/embed.md
+++ b/site/docs/4.1/utilities/embed.md
@@ -25,7 +25,7 @@ Wrap any embed like an `<iframe>` in a parent element with `.embed-responsive` a
 
 ## Aspect ratios
 
-Aspect ratios can be customized with modifier classes.
+Aspect ratios can be customized with modifier classes. By default the following ratio classes are provided:
 
 {% highlight html %}
 <!-- 21:9 aspect ratio -->
@@ -48,3 +48,14 @@ Aspect ratios can be customized with modifier classes.
   <iframe class="embed-responsive-item" src="..."></iframe>
 </div>
 {% endhighlight %}
+
+Within `_variables.scss`, you can change the aspect ratios you want to use. Here's an example of the `$embed-responsive-aspect-ratios` list:
+
+{% highlight scss %}
+$embed-responsive-aspect-ratios: (
+  (21 9),
+  (16 9),
+  (3 4),
+  (1 1)
+) !default;
+{% endhighlight %}