CSS

The object-fit Property

The CSS object-fit property is used to specify how an
<img> or <video> should be resized to fit its container.

The CSS object-fit Property

The CSS object-fit property is used to specify how an <img> or <video> should
be resized to fit its container.

This property tells the content to fill the container in a variety of ways; such as
“preserve that aspect ratio” or “stretch up and take up as much space as
possible”.

Look at the following image from Paris. This image is 400 pixels wide and 300 pixels high:

However, if we style the image above to be half its width (200 pixels) and
same height (300 pixels), it will look like this:

Example

img {
  width: 200px;
  height:
300px;
}

Try it Yourself »

We see that the image is being squished to fit the container of 200×300 pixels
(its original aspect ratio is destroyed).

Here is where the object-fit property comes
in. The object-fit property can take one of the
following values:

• fill – This is default. The image is resized to fill the
  given dimension. If necessary, the image will be stretched or squished to fit
• contain – The image
  keeps its aspect ratio, but is resized to fit within the given dimension
• cover – The image keeps its aspect ratio
  and fills the given dimension. The image will be clipped to fit
• none – The image is not resized
• scale-down – the image is
  scaled down to the smallest version of none or
contain

Using object-fit: cover;

If we use object-fit: cover; the image keeps its aspect ratio
and fills the given dimension. The image will be clipped to fit:

Example

img {
  width: 200px;
  height:
300px;
  object-fit: cover;
}

Try it Yourself »

Using object-fit: contain;

If we use object-fit: contain; the image
keeps its aspect ratio, but is resized to fit within the given dimension:

Example

img {
  width: 200px;
  height:
300px;
  object-fit: contain;
}

Try it Yourself »

Using object-fit: fill;

If we use object-fit: fill; the image is
resized to fill the given dimension. If necessary, the image will be
stretched or squished to fit:

Example

img {
  width: 200px;
  height:
300px;
  object-fit: fill;
}

Try it Yourself »

Using object-fit: none;

If we use object-fit: none; the image is not
resized:

Example

img {
  width: 200px;
  height:
300px;
  object-fit: none;
}

Try it Yourself »

Using object-fit: scale-down;

If we use object-fit: scale-down; the image is
scaled down to the smallest version of none or
contain:

Example

img {
  width: 200px;
  height:
300px;
  object-fit: scale-down;
}

Try it Yourself »

Another Example

Here we have two images and we want them to fill the width of 50% of the browser window and 100% of the height.

In the following example we do NOT use object-fit, so when we resize the browser window, the aspect ratio of the images will be destroyed:

In the next example, we use object-fit: cover;, so when we resize the browser window, the aspect ratio of the images
is preserved:

 CSS object-fit More Examples

The following example demonstrates all the possible values of the object-fit property
in one example:

CSS Object-* Properties

The following table lists the CSS object-* properties:

Property
Description

object-fit
Specifies how an <img> or <video> should be resized to fit its container

object-position
Specifies how an <img> or <video> should be positioned with x/y
coordinates inside its “own content box”