CSS property · data last changed 10 Nov 2026
background-repeat in email clients
Works in 20 of 21. Not supported in Outlook Classic.
Your reader in Outlook Classic sees the email without background-repeat, even if it looks right where you tested it.
caniemail (MIT) via @emailens/engine 0.18.22
What to do instead in Outlook Classic
Always pair background-repeat: no-repeat with a solid bgcolor and background-color. For Outlook Classic, use Microsoft VML: specify <v:fill type="frame"> for single stretched/non-repeating backgrounds or <v:fill type="tile"> for seamless patterns.
- Background images repetition can be used in VML with the
type="tile"ortype="frame"attribute. See VML documentation.
No signup · Five clients free, Outlook Classic included · All 21 with an account
The checker needs a computer screen.
A free account opens all 21 clients and keeps your checks for 7 days. Create a free account →
Every account includes one free real-device check in classic Outlook, Outlook for Mac and Apple Mail, after you verify your email and run one preview, while this month's free capacity lasts. How real-device checks work →
background-repeat is not among the 24 features we have screenshotted on real installs. The ones we have →
All 21 clients, problems first
| Client | Support |
|---|---|
| Outlook Classic | Not supported See caveat 1 |
Works in 20: Gmail, Gmail Android, Gmail iOS and 17 more. Show all
| Client | Support |
|---|---|
| Gmail | Works |
| Gmail Android | Works |
| Gmail iOS | Works |
| Outlook 365 | Works |
| Outlook (New) | Works |
| Outlook iOS | Works |
| Outlook Android | Works |
| Outlook for Mac | Works |
| Apple Mail | Works |
| Apple Mail iOS | Works |
| Yahoo Mail | Works See caveat 2 |
| Yahoo Mail Android | Works See caveat 2 |
| Yahoo Mail iOS | Works See caveat 2 |
| Samsung Mail | Works |
| Thunderbird | Works |
| HEY Mail | Works |
| Proton Mail | Works |
| AOL Mail | Works See caveat 2 |
| Fastmail | Works |
| Superhuman | Works |
Caveats (2)
- 1. Outlook Classic: Background images repetition can be used in VML with the
type="tile"ortype="frame"attribute. See VML documentation. - 2. Yahoo Mail, Yahoo Mail Android, Yahoo Mail iOS, AOL Mail: Partial. Does not support multiple values. The comma between two values is removed.
Caveats as recorded by caniemail (MIT), one entry per wording.
How background-repeat behaves
background-repeat controls whether and how background images tile across an element (e.g., repeat, no-repeat, repeat-x, repeat-y). In email development, it is critical for hero banners, patterned textures, and textured buttons, but requires careful coordination with VML in Outlook Classic.
- Outlook Classic ignores CSS background-repeat: no-repeat on HTML elements, repeating the image by default unless wrapped in a VML <v:fill type="frame"> or <v:fill type="tile">.
- Gmail supports background-repeat when declared inline on <td> or <div> elements.
- Yahoo Mail and AOL Mail remove commas between multiple background values, limiting support to single background layers.
- Apple Mail and modern webmail clients support all standard background-repeat values, including repeat-x and repeat-y.
Questions
Why does my background image repeat in Outlook even with no-repeat?
Outlook Classic uses Word's rendering engine, which does not recognize CSS background-repeat. It tiles any HTML background by default. You must use VML <v:rect> with <v:fill type="frame"> to prevent tiling in Outlook.
Does background-repeat work in Gmail?
Yes, Gmail respects background-repeat: no-repeat when applied inline on a <td> element with a declared background image.
Your next question
- Does word-break work in Outlook Classic?
Works in 4 of 21 · partial in 12 · not supported in 5
fix - Does display:flex work in Outlook Classic?
Works in 18 of 21 · partial in 2 · not supported in 1
fix - Does display:grid work in Outlook Classic?
Works in 18 of 21 · partial in 2 · not supported in 1
fix - Does border-spacing work in Outlook Classic?
Works in 17 of 21 · not supported in 2 · 2 untested
fix - Does border-radius work in Outlook Classic?
Works in 16 of 21 · partial in 4 · not supported in 1
fix - Does visibility work in Outlook Classic?
Works in 13 of 21 · not supported in 8
fix
Every feature in Outlook Classic · All email CSS features · What real installs show
Paste your email
Get new email CSS fixes by email.