The object-fit CSS property sets how the content of a replaced element, such as an <img> or <video> , should be resized to fit its container.

You can alter the alignment of the replaced element's content object within the element's box using the object-position property.

The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.

Syntax

The object-fit property is specified as a single keyword chosen from the list of values below.

Values

contain The replaced content is scaled to maintain its aspect ratio while fitting within the element’s content box. The entire object is made to fill the box, while preserving its aspect ratio, so the object will be "letterboxed" if its aspect ratio does not match the aspect ratio of the box. cover The replaced content is sized to maintain its aspect ratio while filling the element’s entire content box. If the object's aspect ratio does not match the aspect ratio of its box, then the object will be clipped to fit. fill The replaced content is sized to fill the element’s content box. The entire object will completely fill the box. If the object's aspect ratio does not match the aspect ratio of its box, then the object will be stretched to fit. none The replaced content is not resized. scale-down The content is sized as if none or contain were specified, whichever would result in a smaller concrete object size.

Formal definition

Initial value fill Applies to replaced elements Inherited no Computed value as specified Animation type discrete

Formal syntax

Examples

Setting object-fit for an image

HTML

<section> <h2>object-fit: fill</h2> <img class="fill" src="https://mdn.mozillademos.org/files/6457/mdn_logo_only_color.png" alt="MDN Logo"> <img class="fill narrow" src="https://mdn.mozillademos.org/files/6457/mdn_logo_only_color.png" alt="MDN Logo"> <h2>object-fit: contain</h2> <img class="contain" src="https://mdn.mozillademos.org/files/6457/mdn_logo_only_color.png" alt="MDN Logo"> <img class="contain narrow" src="https://mdn.mozillademos.org/files/6457/mdn_logo_only_color.png" alt="MDN Logo"> <h2>object-fit: cover</h2> <img class="cover" src="https://mdn.mozillademos.org/files/6457/mdn_logo_only_color.png" alt="MDN Logo"> <img class="cover narrow" src="https://mdn.mozillademos.org/files/6457/mdn_logo_only_color.png" alt="MDN Logo"> <h2>object-fit: none</h2> <img class="none" src="https://mdn.mozillademos.org/files/6457/mdn_logo_only_color.png" alt="MDN Logo"> <img class="none narrow" src="https://mdn.mozillademos.org/files/6457/mdn_logo_only_color.png" alt="MDN Logo"> <h2>object-fit: scale-down</h2> <img class="scale-down" src="https://mdn.mozillademos.org/files/6457/mdn_logo_only_color.png" alt="MDN Logo"> <img class="scale-down narrow" src="https://mdn.mozillademos.org/files/6457/mdn_logo_only_color.png" alt="MDN Logo"> </section>

CSS

h2 { font-family: Courier New, monospace; font-size: 1em; margin: 1em 0 0.3em; } div { display: flex; flex-direction: column; flex-wrap: wrap; align-items: flex-start; height: 940px; } img { width: 150px; height: 100px; border: 1px solid #000; } .narrow { width: 100px; height: 150px; margin-top: 10px; } .fill { object-fit: fill; } .contain { object-fit: contain; } .cover { object-fit: cover; } .none { object-fit: none; } .scale-down { object-fit: scale-down; }

Result

Specifications

Browser compatibility

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

Update compatibility data on GitHub Desktop Mobile Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet object-fit Chrome Full support 31 Edge Full support 16 Notes Full support 16 Notes Notes Edge supports object-fit on img elements only. See Edge issue 13603873 for details. Firefox Full support 36 IE No support No Opera Full support 19 Full support 19 Full support 11.6 Prefixed Prefixed Implemented with the vendor prefix: -o- Safari Full support 10 WebView Android Full support 4.4.3 Chrome Android Full support 31 Firefox Android Full support 36 Opera Android Full support 19 Full support 19 Full support 12 Prefixed Prefixed Implemented with the vendor prefix: -o- Safari iOS Full support 10 Samsung Internet Android Full support 2.0 Legend Full support Full support No support No support See implementation notes. See implementation notes. Requires a vendor prefix or different name for use. Requires a vendor prefix or different name for use.

See also