background-clip
CSS property · 13 supported, 2 partial, 6 unsupported across 21 clients
13 of 21 email clients render background-clip 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-clip 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-clip, 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.
background-clip controls the area of an element to which the background extends , border-box, padding-box, content-box, or text. Email support is limited: only Apple Mail and a few WebKit-based clients honor background-clip: text reliably, making it an effects-only property best used as progressive enhancement.
Client Support
| Client | Category | Engine | Support |
|---|---|---|---|
| Gmail | webmail | Gmail Web | Supported |
| Gmail Android | mobile | Gmail Mobile | PartialSee caveat 1 |
| Gmail iOS | mobile | Gmail Mobile | PartialSee caveat 1 |
| 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 |
| Outlook for Mac | desktop | WebKit | Supported |
| Apple Mail | desktop | WebKit | Supported |
| Apple Mail iOS | mobile | WebKit | Supported |
| Yahoo Mail | webmail | Yahoo | Unsupported |
| Yahoo Mail Android | mobile | Yahoo | Unsupported |
| Yahoo Mail iOS | mobile | Yahoo | Unsupported |
| Samsung Mail | mobile | Samsung | Supported |
| Thunderbird | desktop | Gecko | Supported |
| HEY Mail | webmail | WebKit | Supported |
| Proton Mail | webmail | Proton | Supported |
| AOL Mail | webmail | AOL | Unsupported |
| Fastmail | webmail | Fastmail | Supported |
| Superhuman | desktop | Blink | Supported |
Documented caveats (1)
- 1.Gmail Android, Gmail iOS: Partial. Not supported with non Google accounts. But it can be used in the
backgroundshorthand property instead.
Caveats recorded by caniemail.com (MIT) and carried verbatim, one entry per wording rather than per client.
Client-by-client behaviour for background-clip
Fully supports background-clip (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-clip in production sends.
When to use background-clip in email
- Gradient text headlines on Apple-Mail-heavy audiences (premium, design-tool, agency newsletters).
- Decorative section dividers that fade their background.
- Hero text overlay effects where the gradient appears only behind text glyphs.
Rendering behaviour and edge cases
- background-clip: text requires -webkit-background-clip: text and color: transparent , both must be inline on the same element.
- Outlook and Gmail ignore background-clip and render with whatever color you set, so always pair with a solid color fallback.
- Layered background-clip stacks (e.g., padding-box + content-box) are unreliable and rarely worth the implementation cost.
Recommended fallback strategy
Set a sensible solid color fallback first, then layer background-clip: text as a progressive enhancement. Wrap critical headlines in spans with both -webkit-background-clip: text and a fallback color so non-supporting clients still display readable text.
Fixes & Workarounds
Outlook (New)
Unsupported"background-clip" is not supported in this email client.
Outlook Classic
Unsupported"background-clip" is not supported in this email client.
Yahoo Mail
Unsupported"background-clip" is not supported in this email client.
Yahoo Mail Android
Unsupported"background-clip" is not supported in this email client.
Yahoo Mail iOS
Unsupported"background-clip" is not supported in this email client.
AOL Mail
Unsupported"background-clip" is not supported in this email client.
Gmail Android
Partial"background-clip" is not supported in this email client.
Gmail iOS
Partial"background-clip" is not supported in this email client.
Related Features
Check your own HTML for background-clip
Paste your own, or run the sample below. Analyzed in this page, with no signup and nothing stored.
Test your background-clip layout across 21 email clients
Preview rendering, catch CSS issues, and see how background-clip 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-clip 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.