← CSS Support IndexDoes CSS
Does CSS background-position Work in HTML Email?
Sets the starting position of a background image within its container.
Quick Answer
Does background-position work in HTML email?
The CSS background-position property is supported in Gmail, Outlook (Mac / Web), Apple Mail, Yahoo! Mail, and others. It is NOT supported in Outlook (Windows). Always include a safe fallback for unsupported clients.
Which Email Clients Support CSS background-position?
CSS support for background-position across email clients
| Email Client | Desktop | Mobile / Web | Notes |
|---|---|---|---|
| Gmail | ✓ Yes | ✓ Yes | — |
| Outlook (Windows) | ✗ No | ? | — |
| Outlook (Mac / Web) | ✓ Yes | ✓ Yes | — |
| Apple Mail | ✓ Yes | ✓ Yes | — |
| Yahoo! Mail | ✓ Yes | ✓ Yes | — |
| Samsung Email | ? | ✓ Yes | — |
| Thunderbird | ✓ Yes | ? | — |
| ProtonMail | ✓ Yes | ✓ Yes | — |
| Fastmail | ✓ Yes | ? | — |
Notes
- #1 Partial. Does not support multiple values. The comma between two values is removed.
- #2 Background images position can be used in VML with the `position` attribute. See [VML documentation](https://docs.microsoft.com/en-us/windows/win32/vml/position-attribute--fill--vml).
Frequently Asked Questions
Related CSS Properties
Test Your Email Now
Paste your HTML and see how it renders in clients that don't support background-position.