← CSS Support Index

Does CSS list-style-image Work in HTML Email?

Replaces the default list item marker with a custom image.

Quick Answer

Does list-style-image work in HTML email?

The CSS list-style-image property is supported in Outlook (Mac / Web), Apple Mail, Samsung Email, Thunderbird, and others. It is NOT supported in Gmail, Outlook (Windows), Yahoo! Mail. Always include a safe fallback for unsupported clients.

Which Email Clients Support CSS list-style-image?

CSS support for list-style-image across email clients

Email ClientDesktopMobile / WebNotes
Gmail✗ No✗ No—
Outlook (Windows)✗ No?—
Outlook (Mac / Web)✓ Yes✗ No—
Apple Mail✓ Yes✓ Yes—
Yahoo! Mail✗ No✗ No—
Samsung Email?✓ Yes—
Thunderbird✓ Yes?—
ProtonMail✗ No✓ Yes—
Fastmail✓ Yes?—

Notes

  • #1 Not supported, but the proprietary `mso-bullet-image` property can be used instead on `<li>`. Outlook 2007 and 2010 only support `.ico` and `.gif` file formats.
  • #2 Not supported, but image values are supported through the `list-style` shorthand property.
  • #3 `url()` is transformed into `proton-url()`.

Frequently Asked Questions

Related CSS Properties

Test Your Email Now

Paste your HTML and see how it renders in clients that don't support
list-style-image.

Open Email Previewer

Building a new email instead of checking an existing one? MailViewr's Email Builder only lets you use CSS that's known to render across clients, so list-style-image can't sneak into your markup by accident. Open the Email Builder →