CSS aspect-ratio Property
Sets a preferred aspect ratio for an element's box, used in auto-sizing calculations
Syntax
aspect-ratio: auto | <ratio>;Values
| Value | Description |
|---|---|
| auto | No preferred aspect ratio (default) |
| 1 / 1 | Square |
| 16 / 9 | Widescreen |
| 4 / 3 | Standard TV ratio |
| auto 16 / 9 | Intrinsic or 16:9 fallback |
Example
.video-embed {
aspect-ratio: 16 / 9;
width: 100%;
}
.avatar {
aspect-ratio: 1;
border-radius: 50%;
}Understanding CSS aspect-ratio
The CSS aspect-ratio property sets a preferred aspect ratio for an element's box, used in auto-sizing calculations. As part of the Misc module in CSS, it is one of the most commonly used properties for controlling the visual presentation of web pages.
You can set aspect-ratio to values such as auto, 1 / 1, 16 / 9, 4 / 3, among others. Each value changes how the browser renders the affected element, giving you fine-grained control over your page layout and design. Choosing the right value depends on the specific design requirements of your project.
Common use cases for the aspect-ratio property include responsive web design, component-based layouts, and creating visually consistent interfaces across devices. It works closely with related properties like width, height, object-fit to achieve complex styling effects. Understanding how these properties interact helps you write cleaner, more maintainable stylesheets.
Browser support for aspect-ratio is excellent across all modern browsers including Chrome, Firefox, Safari, and Edge. For older browsers, consider using fallback values or progressive enhancement strategies. The property can also be set dynamically via JavaScript using element.style.aspectRatio or the CSS custom properties (variables) approach for theming.
Related Properties
Explore More CSS Properties
Browse our complete reference of 251 CSS properties with syntax, examples, and tips.