CSS object-fit Property
Specifies how a replaced element's content should be resized to fit its container
Syntax
object-fit: fill | contain | cover | none | scale-down;Values
| Value | Description |
|---|---|
| fill | Stretches to fill the box (default) |
| contain | Scales to fit while preserving aspect ratio |
| cover | Scales to cover while preserving aspect ratio |
| none | Not resized |
| scale-down | Sized as if none or contain were specified, whichever is smaller |
Example
.hero-image {
width: 100%;
height: 300px;
object-fit: cover;
object-position: center;
}Understanding CSS object-fit
The CSS object-fit property specifies how a replaced element's content should be resized to fit its container. As part of the Layout module in CSS, it is one of the most commonly used properties for controlling the visual presentation of web pages.
You can set object-fit to values such as fill, contain, cover, none, 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 object-fit property include responsive web design, component-based layouts, and creating visually consistent interfaces across devices. It works closely with related properties like object-position, aspect-ratio, overflow to achieve complex styling effects. Understanding how these properties interact helps you write cleaner, more maintainable stylesheets.
Browser support for object-fit 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.objectFit or the CSS custom properties (variables) approach for theming.
Related Properties
object-positionSpecifies the alignment of a replaced element's content within its box
aspect-ratioSets a preferred aspect ratio for an element's box, used in auto-sizing calculations
overflowControls what happens to content that overflows an element's box
widthSets the width of an element's content area
heightSets the height of an element's content area
Explore More CSS Properties
Browse our complete reference of 251 CSS properties with syntax, examples, and tips.