🎯 How to Target Email Clients

A collection of crowdsourced email development techniques for singling out email clients and platforms based on research by Mark Robbins.

Using the site

Some code snippets include foo or .foo. This is placeholder code meant to be replaced with your own class names and styles.

For example, the site lists the following method for targetting Gmail:

u + .body .foo

To target Gmail in your own code, you might write something like this:

u + .body .your-class {
  background-color: red;
}

If you know of a targetting methods not yet listed, or have found a listed technique to no longer work, please open an issue or a pull request.

PRs are welcome and should follow the existing file name and format conventions.

All hacks/methods are added one per file in hacks/_posts
Files are named YYYY-MM-DD-client-platform-version.md
Front matter should include client, platform, version, status, and contributor
- client is the name of the email client (ex: Gmail, Apple Mail)
- platform is the operating system or OS category (usually one of iOS, Android, desktop, mobile, or webmail)
- version is usually a number corresponding to the client (ex: 12.4 for Apple Mail 12.4)
- status must be one of Working (tested and confirmed), Unknown (not confirmed), or Deprecated (confirmed no longer working)
- contributor is your name in Title Case
- Note: All fields should be present; if not applicable, leave blank
Code blocks should always be wrapped in fences ( ```) with the language name appended to the opening fence (ex: ```html or ```css)
Explanations of how and why the code works are encouraged and should be added below the code snippets; this can include markup like inline code and links
If this is your first contribution, you should also add yourself to contributors.yml in alphabetical order.

See Jekyll’s quick start guide for running the site in local development.

Curated by Parcel