CSS Properties

object-fit

CSS property · 10 supported, 2 partial, 3 unsupported across 15 clients

Client Support

Client	Category	Engine	Support
Gmail	webmail	Gmail Web	Supported
Gmail Android	mobile	Gmail Mobile	Partial
Gmail iOS	mobile	Gmail Mobile	Partial
Outlook 365	webmail	Outlook Web	Supported
Outlook (New)	desktop	Outlook Web	Unsupported
Outlook Classic	desktop	Microsoft Word	Unsupported
Outlook iOS	mobile	Outlook Mobile	Supported
Outlook Android	mobile	Outlook Mobile	Supported
Apple Mail	desktop	WebKit	Supported
Apple Mail iOS	mobile	WebKit	Supported
Yahoo Mail	webmail	Yahoo	Unsupported
Samsung Mail	mobile	Samsung	Supported
Thunderbird	desktop	Gecko	Supported
HEY Mail	webmail	WebKit	Supported
Superhuman	desktop	Blink	Supported

Client-by-client behaviour for object-fit

Fully supports object-fit (10): Gmail, Outlook 365, Outlook iOS, Outlook Android, Apple Mail, Apple Mail iOS, Samsung Mail, Thunderbird, HEY Mail, Superhuman.

Partial support (2): Gmail Android, Gmail iOS. Expect rendering quirks unique to each engine — partial support typically means a subset of values, an ignored shorthand, or sanitizer-specific rewrites.

No support (3): Outlook (New), Outlook Classic, Yahoo Mail. Plan fallbacks for these clients before relying on object-fit in production sends.

Fixes & Workarounds

Outlook (New)

Unsupported

Use width/height attributes on <img> directly.

Before

<img src="photo.jpg" style="width: 300px; height: 200px;
            object-fit: cover;" />

After

<!-- Crop/resize image server-side to exact dimensions -->
<img src="photo-300x200.jpg" width="300" height="200"
  alt="Photo" style="display: block; border: 0;" />

Use width/height attributes instead of object-fit

Outlook Classic

Unsupported

Use width/height attributes on <img> directly.

Before

<img src="photo.jpg" style="width: 300px; height: 200px;
            object-fit: cover;" />

After

<!-- Crop/resize image server-side to exact dimensions -->
<img src="photo-300x200.jpg" width="300" height="200"
  alt="Photo" style="display: block; border: 0;" />

Use width/height attributes instead of object-fit

Yahoo Mail

Unsupported

Use width/height attributes on <img> directly.

Before

<img src="photo.jpg" style="width: 300px; height: 200px;
            object-fit: cover;" />

After

<!-- Crop/resize image server-side to exact dimensions -->
<img src="photo-300x200.jpg" width="300" height="200"
  alt="Photo" style="display: block; border: 0;" />

Use width/height attributes instead of object-fit

Gmail Android

Partial

Use width/height attributes on <img> directly.

Before

<img src="photo.jpg" style="width: 300px; height: 200px;
            object-fit: cover;" />

After

<!-- Crop/resize image server-side to exact dimensions -->
<img src="photo-300x200.jpg" width="300" height="200"
  alt="Photo" style="display: block; border: 0;" />

Use width/height attributes instead of object-fit

Gmail iOS

Partial

Use width/height attributes on <img> directly.

Before

<img src="photo.jpg" style="width: 300px; height: 200px;
            object-fit: cover;" />

After

<!-- Crop/resize image server-side to exact dimensions -->
<img src="photo-300x200.jpg" width="300" height="200"
  alt="Photo" style="display: block; border: 0;" />

Use width/height attributes instead of object-fit

Production guidance for object-fit

object-fit is a CSS property. Across the email client matrix, 10 of 15 tracked clients support it fully, 2 only partially, and 3 not at all. The clients most likely to require a workaround for this feature are Outlook (New), Outlook Classic, Yahoo Mail. Each of them needs a tailored fallback — see the per-client examples above for the specific code fix Emailens recommends.

When in doubt, ship a baseline that renders without object-fit and treat it as progressive enhancement on clients where support is verified. Emailens automatically detects cross-client divergence on this feature when you preview an email, so you can see exactly which template paths break before a campaign goes out.

Related Features

!important accent-color align-items animation aspect-ratio backdrop-filter background background-blend-mode

Test your email across all 15 clients

Preview rendering, catch CSS issues, and get actionable fixes — free.

Try Emailens Free

Support data last updated Apr 27, 2026 · synced from caniemail.com via @emailens/engine.