Skip to docs navigation

Ratios

Perfect for responsive video or slideshow embeds based on the width of the parent.

Example

Aspect ratio defaults

1x1
4x3
16x9
21x9

Custom ratios

Each .ratio-* class includes a CSS custom property (or CSS variable) in the selector. You can override this CSS variable to create custom aspect ratios on the fly with some quick math on your part.

For example, to create a 2x1 aspect ratio, set --aspect-ratio: 50% on the .ratio.

TODO: Fix box, it shouldn't be flattened.
2x1

This CSS variable makes it easy to modify the aspect ratio across breakpoints. The following is 4x3 to start, but changes to a custom 2x1 at the medium breakpoint.

4x3, then 2x1

Sass map

Within _variables.scss, you can change the aspect ratios you want to use. Here’s our default $ratio-aspect-ratios map. Modify the map as you like and recompile your Sass to put them to use.