Skip to main content
CSS Properties

aspect-ratio

CSS property · 4 supported, 0 partial, 11 unsupported across 15 clients

aspect-ratio locks an element's height to a fraction of its width, preserving ratio across breakpoints. In email, support is recent and uneven: modern Apple Mail and webmail clients honor it, while Outlook and many mobile clients ignore it. Pre-computed width/height attributes remain the most reliable approach.

Client Support

ClientCategoryEngineSupport
GmailwebmailGmail WebUnsupported
Gmail AndroidmobileGmail MobileUnsupported
Gmail iOSmobileGmail MobileUnsupported
Outlook 365webmailOutlook WebUnsupported
Outlook (New)desktopOutlook WebUnsupported
Outlook ClassicdesktopMicrosoft WordUnsupported
Outlook iOSmobileOutlook MobileUnsupported
Outlook AndroidmobileOutlook MobileUnsupported
Apple MaildesktopWebKitSupported
Apple Mail iOSmobileWebKitSupported
Yahoo MailwebmailYahooUnsupported
Samsung MailmobileSamsungUnsupported
ThunderbirddesktopGeckoUnsupported
HEY MailwebmailWebKitSupported
SuperhumandesktopBlinkSupported

Client-by-client behaviour for aspect-ratio

Fully supports aspect-ratio (4): Apple Mail, Apple Mail iOS, HEY Mail, Superhuman.

No support (11): Gmail, Gmail Android, Gmail iOS, Outlook 365, Outlook (New), Outlook Classic, Outlook iOS, Outlook Android, Yahoo Mail, Samsung Mail, Thunderbird. Plan fallbacks for these clients before relying on aspect-ratio in production sends.

When to use aspect-ratio in email

  • Reserving space for hero imagery before the image loads.
  • Maintaining 16:9 video-thumbnail proportions in newsletter recap sections.
  • Square avatar tiles that need to scale fluidly with parent width.

Rendering behaviour and edge cases

  • Outlook on Windows ignores aspect-ratio entirely.
  • Gmail Web honors aspect-ratio in modern Chromium versions but Gmail mobile apps lag behind.
  • Apple Mail respects aspect-ratio reliably across recent macOS and iOS releases.

Recommended fallback strategy

Set explicit width and height attributes on <img> elements so blocked or slow-loading images still reserve their space. Use aspect-ratio as a progressive enhancement on container <div>s where it can avoid layout shift in modern clients.

Fixes & Workarounds

Gmail

Unsupported

"aspect-ratio" is not supported in this email client.

Gmail Android

Unsupported

"aspect-ratio" is not supported in this email client.

Gmail iOS

Unsupported

"aspect-ratio" is not supported in this email client.

Outlook 365

Unsupported

"aspect-ratio" is not supported in this email client.

Outlook (New)

Unsupported

"aspect-ratio" is not supported in this email client.

Outlook Classic

Unsupported

"aspect-ratio" is not supported in this email client.

Outlook iOS

Unsupported

"aspect-ratio" is not supported in this email client.

Outlook Android

Unsupported

"aspect-ratio" is not supported in this email client.

Yahoo Mail

Unsupported

"aspect-ratio" is not supported in this email client.

Samsung Mail

Unsupported

"aspect-ratio" is not supported in this email client.

Thunderbird

Unsupported

"aspect-ratio" is not supported in this email client.

Related Features

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.