The CSS object-fit property is used to control how an image or video is resized to fit its content box. This property offers various methods to fill the content box, such as preserving the aspect ratio or stretching the content to occupy as much space as possible.
Additionally, the alignment position of the replaced element's content within its box can be adjusted using the object-position property. This guide provides an in-depth look at the object-fit property, its syntax, property values, and practical examples to enhance your web design projects.
Understanding the object-fit Property
Syntax:
object-fit: fill|contain|cover|scale-down|none|initial|inherit;
Property Values:
Each property value determines a different way to resize the content within the box:
1. fill: It is a default value. The replaced image is stretched to fit the content box. The replaced image will completely fill the box heedless of its aspect ratio.
Syntax:
object-fit: fill;
Example: This example illustrates the use of the object-fit property whose value is set to fill.
HTML
<!DOCTYPE html>
<html>
<head>
<title> CSS | The object-fit Property </title>
<style>
img {
width: 200px;
height: 400px;
object-fit: Fill;
}
</style>
</head>
<body>
<img src=
"https://media.geeksforgeeks.org/wp-content/uploads/geeksforgeeks-logo.png"
alt="GeeksforGeeks"
width="667"
height="184">
</body>
</html>
Output:

2. contain: The replaced image preserves the aspect ratio of the original image while fitting within the content box.
Syntax:
object-fit: contain;
Example: This example illustrates the use of the object-fit property whose value is set to contain.
HTML
<!DOCTYPE html>
<html>
<head>
<title> CSS | The object-fit Property </title>
<style>
img {
width: 200px;
height: 400px;
object-fit: contain;
}
</style>
</head>
<body>
<img src=
"https://media.geeksforgeeks.org/wp-content/uploads/geeksforgeeks-logo.png"
alt="GeeksforGeeks"
width="667"
height="184">
</body>
</html>
Output:

3. cover: This value also preserves the aspect ratio of the original image is the replaced image while fitting in the content box. Sometimes it is clipped to fit when the aspect ratio of the original image doesn’t match with the aspect ratio of the content box.
Syntax:
object-fit: cover;
Example: This example illustrates the use of the object-fit property whose value is set to cover.
HTML
<!DOCTYPE html>
<html>
<head>
<title> CSS | The object-fit Property </title>
<style>
img {
width: 200px;
height: 400px;
object-fit: cover;
}
</style>
</head>
<body>
<img src=
"https://media.geeksforgeeks.org/wp-content/uploads/geeksforgeeks-logo.png"
alt="GeeksforGeeks"
width="667"
height="184">
</body>
</html>
Output:

4. none: The replaced image will ignore the aspect ratio of the original image. Hence, it is not resized.
Syntax:
object-fit: none;
Example: This example illustrates the use of the object-fit property whose value is set to none.
HTML
<!DOCTYPE html>
<html>
<head>
<title> CSS | The object-fit Property </title>
<style>
img {
width: 200px;
height: 400px;
object-fit: none;
}
</style>
</head>
<body>
<img src=
"https://media.geeksforgeeks.org/wp-content/uploads/geeksforgeeks-logo.png"
alt="GeeksforGeeks"
width="667"
height="184">
</body>
</html>
Output:

5. scale-down: The replaced image is resized as if none or contain were specified and results in the smallest object size.
Syntax:
object-fit: scale-down;
Example: This example illustrates the use of the object-fit property whose value is set to scale-down.
HTML
<!DOCTYPE html>
<html>
<head>
<title> CSS | The object-fit Property </title>
<style>
img {
width: 200px;
height: 200px;
object-fit: scale-down;
}
</style>
</head>
<body>
<img src=
"https://media.geeksforgeeks.org/wp-content/uploads/geeksforgeeks-logo.png"
alt="GeeksforGeeks"
width="667"
height="184">
</body>
</html>
Output:

6. initial: It is used to set the default value i.e. replaced image is stretched to fit the content box as the default value is filled.
Syntax:
object-fit: initial;
Example: This example illustrates the use of the object-fit property whose value is set to initial.
HTML
<!DOCTYPE html>
<html>
<head>
<title> CSS | The object-fit Property </title>
<style>
img {
width: 200px;
height: 400px;
object-fit: initial;
}
</style>
</head>
<body>
<img src=
"https://media.geeksforgeeks.org/wp-content/uploads/geeksforgeeks-logo.png"
alt="GeeksforGeeks"
width="667"
height="184">
</body>
</html>
Output:

7. inherit: Inherit receives the property from the parent element. When it is used with the root element then the initial property will be used.
Syntax:
object-fit: inherit;
Example: This example illustrates the use of the object-fit property whose value is set to inherit.
HTML
<!DOCTYPE html>
<html>
<head>
<title> CSS | The object-fit Property </title>
<style>
.object {
object-fit: none;
}
img {
width: 200px;
height: 400px;
object-fit: inherit;
}
</style>
</head>
<body>
<div class="object">
<img src=
"https://media.geeksforgeeks.org/wp-content/uploads/geeksforgeeks-logo.png"
alt="GeeksforGeeks"
width="667"
height="184">
</div>
<!--Here img inherits property from parent i.e none from class object-->
</body>
</html>
Output:

The CSS object-fit property provides a flexible way to control how images and videos are resized within their content boxes. By using values such as fill, contain, cover, none, scale-down, initial, and inherit, developers can ensure that media elements are displayed correctly and consistently across different devices and screen sizes. Understanding and utilizing the object-fit property effectively can significantly enhance the visual appeal and functionality of your web designs. Experiment with the examples provided to see how each property value affects the resizing behavior and improve your web development projects.
Supported Browsers: The browsers supported by object-fit Property are listed below:
- Google Chrome 32.0
- Firefox 36.0
- Microsoft Edge 79.0
- Opera 19.0
- Safari 10.0
Similar Reads
CSS Tutorial CSS stands for Cascading Style Sheets. It is a stylesheet language used to style and enhance website presentation. CSS is one of the three main components of a webpage, along with HTML and JavaScript.HTML adds Structure to a web page.JavaScript adds logic to it and CSS makes it visually appealing or
7 min read
CSS Introduction CSS (Cascading Style Sheets) is a language designed to simplify the process of making web pages presentable.It allows you to apply styles to HTML documents by prescribing colors, fonts, spacing, and positioning.The main advantages are the separation of content (in HTML) and styling (in CSS) and the
4 min read
CSS Syntax CSS is written as a rule set, which consists of a selector and a declaration block. The basic syntax of CSS is as follows:The selector is a targeted HTML element or elements to which we have to apply styling.The Declaration Block or " { } " is a block in which we write our CSS.HTML<html> <h
2 min read
CSS Selectors CSS Selectors are used to target HTML elements on your pages, allowing you to apply styles based on their ID, class, type attributes, and more. There are mainly 5 types of selectors.Basic CSS Selectors: These are used to target elements by tag, .class, or # ID for fundamental styling needs.Combinato
7 min read
CSS Comments CSS comments are used to add notes or explanations to your code, helping you and others understand it better. They start with /* and end with */ and can be used for both single-line and multi-line comments. Note: Comments are ignored by browsers, so they wonât affect how your webpage looks or works.
2 min read
CSS Colors CSS colors are used to set the color of different parts of a webpage, like text, background, and borders. This helps make the page look more attractive and easier to read. You can define colors using names, hex codes, RGB values, and more.You can try different formats of colors here- #content-iframe
5 min read
CSS Borders Borders in CSS are used to create a visible outline around an element. They can be customized in terms ofWidth: The thickness of the border.Style: The appearance of the border (solid, dashed, dotted, etc.).Color: The color of the border.You can try different types of borders here- #custom-iframe{ he
5 min read
CSS Margins CSS margins are used to create space around an element, separating it from neighboring elements and the edges of the webpage. They control the layout by adjusting the distance between elements, providing better organization and readability.Syntax:body { margin: value;}HTML<html> <head>
4 min read
CSS Height and Width Height and Width in CSS are used to set the height and width of boxes. Their values can be set using length, percentage, or auto.Width and HeightThe width and height properties in CSS are used to define the dimensions of an element. The values can be set in various units, such as pixels (px), centim
4 min read
CSS Outline CSS outline is a property used to draw a line around an element's border. It does not affect the layout, unlike borders. It's often used to highlight elements, providing a visual emphasis without altering the dimensions of the element.Syntaxselector{ outline: outline-width outline-type outline-color
4 min read