Skip to main content
Emailens
CSS Properties

background-origin

CSS property · 13 supported, 2 partial, 6 unsupported across 21 clients

13 of 21 email clients render background-origin fully (Sep 2, 2026 data); it breaks outright in Outlook (New), Outlook Classic, Yahoo Mail and 3 more.

  • 5/7 webmail, 4/6 desktop, 4/8 mobile clients support background-origin fully.
  • Unsupported in Outlook (New), Outlook Classic, Yahoo Mail, Yahoo Mail Android and 2 more.
  • Partial in Gmail Android, Gmail iOS, behavior differs from browsers, test before relying on it.
  • Outlook Classic (Word engine, supported to at least 2029) does not fully support background-origin, and its replacement changes little here; see the deprecation diff.
  • Across all clients, only 6 of 298 tracked HTML/CSS features render identically everywhere.

Source: caniemail.com (MIT), via the Emailens engine. Last tested upstream Feb 28, 2019, synced by Emailens Sep 2, 2026.

Client Support

ClientCategoryEngineSupport
GmailwebmailGmail WebSupported
Gmail AndroidmobileGmail MobilePartial
Gmail iOSmobileGmail MobilePartial
Outlook 365webmailOutlook WebSupported
Outlook (New)desktopOutlook WebUnsupportedSee caveat 1
Outlook ClassicdesktopMicrosoft WordUnsupported
Outlook iOSmobileOutlook MobileSupported
Outlook AndroidmobileOutlook MobileSupported
Outlook for MacdesktopWebKitSupported
Apple MaildesktopWebKitSupported
Apple Mail iOSmobileWebKitSupported
Yahoo MailwebmailYahooUnsupported
Yahoo Mail AndroidmobileYahooUnsupported
Yahoo Mail iOSmobileYahooUnsupported
Samsung MailmobileSamsungSupported
ThunderbirddesktopGeckoSupported
HEY MailwebmailWebKitSupported
Proton MailwebmailProtonSupported
AOL MailwebmailAOLUnsupported
FastmailwebmailFastmailSupported
SuperhumandesktopBlinkSupported

Documented caveats (1)

  1. 1.Outlook (New): Background images origin can be used in VML with the origin attribute. See VML documentation.

Caveats recorded by caniemail.com (MIT) and carried verbatim, one entry per wording rather than per client.

Client-by-client behaviour for background-origin

Fully supports background-origin (13): Gmail, Outlook 365, Outlook iOS, Outlook Android, Outlook for Mac, Apple Mail, Apple Mail iOS, Samsung Mail, Thunderbird, HEY Mail, Proton Mail, Fastmail, 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 (6): Outlook (New), Outlook Classic, Yahoo Mail, Yahoo Mail Android, Yahoo Mail iOS, AOL Mail. Plan fallbacks for these clients before relying on background-origin in production sends.

Fixes & Workarounds

Outlook (New)

Unsupported

"background-origin" is not supported in this email client.

Outlook Classic

Unsupported

"background-origin" is not supported in this email client.

Yahoo Mail

Unsupported

"background-origin" is not supported in this email client.

Yahoo Mail Android

Unsupported

"background-origin" is not supported in this email client.

Yahoo Mail iOS

Unsupported

"background-origin" is not supported in this email client.

AOL Mail

Unsupported

"background-origin" is not supported in this email client.

Gmail Android

Partial

"background-origin" is not supported in this email client.

Gmail iOS

Partial

"background-origin" is not supported in this email client.

Related Features

Check your own HTML for background-origin

Paste your own, or run the sample below. Analyzed in this page, with no signup and nothing stored.

Zero-Friction Engine Preview

Test your background-origin layout across 21 email clients

Preview rendering, catch CSS issues, and see how background-origin displays across Outlook, Gmail, and Apple Mail. Free, no account needed.

Instant live preview · No signup required · 21 email engines

Last tested upstream: · Last synced by Emailens:

caniemail.com (MIT) records Feb 28, 2019 as the last time background-origin was tested in a real client, 7 years before this sync. Syncing copies that result forward, it does not re-test it. Carried in @emailens/engine data v0.12.2.