HTML email: Two words that, when combined, brings tears to a developer’s eyes. If you’re a web developer, it’s inevitable that coding an email will be a task that gets dropped in your lap at some time in your career, whether you like it or not. Coding HTML email is old school. Think back to 1999, when we called ourselves “webmasters” and used Frontpage, WYSIWYG editors and tables to mark up our websites.
Not much has changed in email design. In fact, it has gotten worse. With the introduction of mobile devices and more and more email clients, we have even more caveats to deal with when building HTML email.
I’ve spent the past several years building development tools — two of those years as product design lead at Mailgun1, an email service for developers, where I learned a lot about how email works and the problems that developers face when building HTML email. In this post, I’ll share some of my knowledge about the topic.
Introduction To Sending Email Link
As a developer responsible for an email campaign or all of the emails your company sends, you will need to know how email works, the legal requirements and how to actually get email delivered. Companies send a few different types of email. Let’s take a look.
Marketing Email Link
A lot of email service providers (ESPs) specialize in marketing and promotional emails: Campaign Monitor2, MailChimp3, Emma4, Constant Contact5, to name just a few. They provide full solutions for managing subscribers, working with email templates, running bulk email campaigns and reporting.
Transactional Email Link
Transactional email includes receipts, alerts, welcome emails, password resets and so on, and it is typically implemented with development tools and APIs such as Mailgun6, SendGrid7 and Postmark8. These tools are more API-focused, less CMS- and WYSIWYG-based; however, combined with a service such as Sendwithus9, they can be made even more powerful.
An alternative to using a service is to roll your own email server with something like Postfix10. The downside of this is that it’s up to you to set up and configure it and to understand the technical details of sending email, implementing tracking and unsubscribing, and getting email delivered to inboxes.
Life-Cycle Email Link
Life-cycle and behavior-based email services help with onboarding, engagement and more. A lot of ESPs focused on marketing also offer this service, but I tend to group services such as Intercom11, Customer.io12, Drip13, Vero14 and ConvertKit15 into this category.
Email List Best Practices Link
Don’t buy email lists. Maybe a handful of legit services are out there, but you’re best off staying away from buying lists altogether.
My experience is that anyone who buys an email list will suffer from a lot of bounces, give their Internet Protocol (IP) address a bad reputation, and get their emails blocked by Internet service providers (ISPs) or sent to spam. 85% of the world’s email is considered spam, according to SenderBase16; don’t fall into this bucket.
Double Opt-In Link
A subscriber having to verify their email address adds an extra step to the process, but it makes sense and stops other people from abusing their email address by signing them up for lists without their permission. It also helps to keep your subscription list clean and is the “100% correct way to validate an email address18”.
CAN SPAM Link
- Don’t use false or misleading header information.
- Don’t use deceptive subject lines.
- Identify the message as an ad.
- Tell recipients where you’re located.
- Tell recipients how to opt out of future email from you.
- Honor opt-out requests promptly.
- Monitor what others are doing on your behalf.
Analytics And Measuring Performance Link
Measure everything. You need to measure to know whether your emails are improving. The numbers will differ vastly depending on what you do, your industry, the type of emails you send and the context. However, in general:
- 20% is a good open rate,
- 3 to 7% is a good clickthrough rate,
- 5% is a poor bounce rate,
- 0.01% is a poor spam rate,
- 1% is a poor unsubscribe rate.
Also, remember that open rates and clickthrough rates can be vanity metrics (read “they don’t really matter”). At the end of the day, what you really want to track is that end goal or conversion. At Airbnb they track an email quality score23, which is a good indicator on engagement quality.
Sending Score And Reputation Link
Your emails have a reputation and score associated with them. This affects how ISPs and mailbox providers deal with your email, whether they accept or reject it and whether they send it to the recipient’s inbox or straight to spam.
Some contributing factors are:
- your IP reputation (check yours with SenderScore25),
- your domain name signature (see DKIM26 and SPF27),
- bounce rates and complaint rates.
Sending Bulk Email Link
When you send a lot of emails (imagine a campaign with millions of emails), they are not all sent instantaneously. They can only be sent as fast as the servers and IP addresses can handle them. Keep in mind that your recipients might not receive the emails at exactly the same time.
So, if you’re sending millions of emails at once, you’ll probably want quite a few IPs to handle the load.
Email Clients Link
Litmus keeps track of the market share of email clients29, based on its own internal statistics. Keep in mind that this is probably not the same for your customer base, but it is a good indicator to go by.
Here are the statistics as of December 2016:
- iPhone: 33%
- Gmail: 19%
- iPad: 12%
- Android: 8%
- Apple Mail: 7%
Bear in mind that not all emails can be tracked. Email tracking is done via pixel-tracking, so only those clients with images enabled will report back.
HTML Templates Link
Building HTML email templates can be a slog. As a result, a lot of poorly designed email is out there — clunky, themed, verbose, pointless, distracting. If you enjoy a challenge or want a unique look and feel, then building your own can actually be fun and rewarding. Alternatively, some good email templates are available:
Building HTML Email Templates Link
Now you know how to properly set up and send emails. The next decision you’ll make is whether to code your own HTML template. This is a bit more complex than coding the average web page. Let’s dive in.
Client-Rendering Engines Link
Email design is still in the dark ages. Due to the numerous email clients and devices, your email will get rendered for users in a variety of ways.
Email clients use different engines to render HTML emails:
- Apple Mail, Outlook for Mac, Android Mail and iOS Mail use WebKit.
- Outlook 2000, 2002 and 2003 use Internet Explorer.
- Outlook 2007, 2010 and 2013 use Microsoft Word (yes, Word!).
- Web clients use their browser’s respective engine (for example, Safari uses WebKit and Chrome uses Blink).
Clients will also add their own flavor of styles on top of yours. For example, Gmail sets all
Look at your own statistics so that you know what to design for.
Gmail Support for Inline CSS and Media Queries Link
Using HTML Tables For Layout Link
Divs have positioning and box-model issues in different clients — in particular, those that use Microsoft Word to render (i.e. Outlook). You can use divs if you want, but it’s safer to code like it’s 1999 and stick to tables. This means:
- CSS2 instead of CSS3,
- HTML4 instead of HTML5,
- HTML attributes instead of CSS,
- inline CSS instead of style sheets or
These are best practices. You could certainly ignore the safe route and go above and beyond.
Inline CSS Link
Some clients (most notably Gmail until recently) will strip any CSS that isn’t inlined. You have a couple of options here:
- write CSS inline as you go,
- use a web-based CSS inliner,
- use a programmatic CSS inliner,
- let your ESP handle the inlining for you (if it supports it).
37Writing inline as you go isn’t exactly a scalable or maintainable solution,so I tend not to recommend this,but I know that a lot of email developers prefer this in order to maintain 100% control. If you do write your CSS inline manually,then I recommend making use of snippets38and/or a templating language with partials and helpers39. This will save you from having to repeat yourself.
Trying to achieve the perfect cross-client button is painful. As mentioned,you should be using tables and table cells for pretty much everything,including buttons.
My preference is to use the following solution. Here is how you might normally style a button for the web:
Instead,write it like this:
Then,once your CSS is inlined,it will look like this:
46What’s going on here? The first
is a wrapper to help us center the button. The second is the size of the button. Some clients (such as Outlook) don’t recognize the padding on the
tag,so we fill in the background color of the table cell. The
tag then takes up space available in the second
,and the whole area becomes clickable. Check out the code and client tests on Litmus47.
This is just one way to implement buttons in email. Admittedly,it doesn’t always look identical in every client,but the web is not always pixel-perfect either. I prefer this because it’s simpler and doesn’t involve using image assets or VML.
What’s VML?If you’ve spent any time developing emails,you’ve likely come across some reference to it. Vector Markup Language (VML) is supported by old versions of Outlook. According to Microsoft48,as of Internet Explorer (IE) 10,VML is obsolete,which means that it is no longer supported in new versions of IE. However,as long as Outlook 2007,2010 and 2013 are around,you will see it being used,typically for background images.
In general,sticking with standard system fonts is easiest. This includes Helvetica,Arial and so on. However,we can use web fonts,such as Google Fonts. Put them behind a WebKit conditional media query,so that Outlook doesn’t mess them up:
Remember to include a font family, font size and color for every
, or else you risk the client overwriting your carefully chosen type styles.
We can apply specific CSS styles and show or hide elements and content for different versions of Outlook.
The following targets all Microsoft Word-based versions of Outlook:
This next snippet targets all IE-based versions of Outlook:
We can also target specific version numbers of Outlook:
We can target WebKit-based clients with a media query:
.special-webkit-element display: none; @media screen and (-webkit-min-device-pixel-ratio:0) .special-webkit-element display: block !important;
Images And Media Link
Images in Email Link
Some clients will show images by default. Some won’t. Keep this in mind when including images in your email content. This also affects tracking metrics, because images will typically be used to track opens.
- Outlook blocks image-rendering by default.
- Apple Mail doesn’t.
- Gmail doesn’t (anymore).
Remember to include good
alttext for all of your images. The text could either tell the user what the image says or just describe what it is (for example, “company logo”). You can get creative with
alttext49 for clients that turn off images, as Email Monks does:
50Remember to include a basic reset for all images:
Animated GIFs are supported in most clients. Outlook versions 2007 to 2013 do not support animated GIFs, instead falling back to the first frame.
Scalable vector graphics (SVGs) have a lot of advantages on the web. As you would expect, email support varies, and SVG requires a couple of fallback hacks or conditionals. I typically recommend staying away from SVG in email, but if you want to get serious about it, then CSS-Tricks has a guide on SVG support in email53.
Keep in mind that, for Outlook, you need to declare how wide an image should be with the
widthattribute. Otherwise, Outlook might render the actual width of the image and break your email.
Video in Email Link
Forms In Email Link
Obviously, it depends on your objectives. Staying away from forms is safer, but Rebelmail58 and Mixmax59 have done interesting things with forms for surveys and e-commerce, with good fallback support.
Gmail Actions Link
Something important but often forgotten is preheader text. Some clients show preview text next to or under the subject line. These clients include iOS, Apple Mail, Outlook 2013, Gmail and AOL.
Clients will grab the first bit of text they find in your email’s body and display it here. Make the most of this and add a hidden element to your body’s content that appears first. This text should provide an extra incentive for the user to open your email. Hide the text like so:
Testing Email Link
I don’t think I’ve ever sent an email successfully the first time. There is always something to fix, always a typo, always a rendering issue in Outlook, always something I’ve forgotten to add.
You can test your email in a few ways:
- Send an email to yourself and check it on a desktop client (Outlook), a web client (Gmail) and a mobile client (iOS Mail).
- Automate tests using Litmus65 or Email on Acid66.
- Proofread the content, and check the layout renders.
- A/B test various types of content, lengths of content and subject lines.
MIME Multi-Part Link
A plain-text email is just that, plain text. An HTML email is just HTML. Most emails you send or receive are MIME (Multipurpose Internet Mail Extensions) multi-part emails (not to be confused with MIME type70). This standard combines both plain text and HTML, leaving it up to the recipient to decide which to render.
When you send an email, whether transactional or bulk, include both the HTML and plain-text versions. Even if, in your mind, every one uses a client that renders HTML, still send plain text.
71Also, note that some clients render plain-text email as HTML; for example, Gmail will add some default styles and turn URLs into links. Most ESPs will construct the MIME for you, so you don’t really need to worry about it. Some will also create a plain-text version, based on your HTML.
Pro tip: In Gmail, select “Show original” from the dropdown menu to see the full MIME.
72A new MIME part has surfaced:
text/watch-html. This content will only be displayed in Apple Watch73 (and any other clients that support this MIME type going forward).
On the web, if you follow standards and best practices and use semantic markup and valid HTML syntax, you tend to get basic accessibility out of the box. Unfortunately, with email, due to our excessive hacks and the poor support for HTML, accessibility is often ignored.
role="presentation"to each table so that it’s clear the table is being used for layout.
alttext with meaningful descriptions.
- If you don’t need or want
alttext, then use
alt=""so that screen readers know it is meant to be blank.
- Use semantic HTML tags, such as
, where applicable.
- Use the
roleattribute for elements such as headers and footers (for example,
Responsive Email Design Link
- Email opens on mobile are at 50% and rising75. The exact metric depends on which report you check and which audience you cater to, but I think we can all agree that this is important.
- Email Client Market Share76, as of August 2016, puts iPhone at 33%, iPad at 11% and Android at 10% (that’s over 50%!).
- MailChimp77 found that unique clicks among mobile users for responsive campaigns rose from 2.7 to 3.1% — a nearly 15% increase.
By marrying fluid, grid-based layouts and CSS3 media queries, we can create one design, that, well, responds to the shape of the display rendering it.
In the email world, we can still make use of fluid design, grid-based layouts and media queries. The problem is that not all clients support these. Therefore, we need some hacks along the way.
Until recently, Gmail did not support media queries. Thankfully, as of September 2016, most of its clients do79. However, several mobile clients still do not, including Yahoo, Windows Phone 8 and Gmail for Android.
Several techniques are used in the email world to get around a lack of support for media queries. Some of the terms you’ll hear are “fluid,” “adaptive,” “responsive,” “hybrid” and “spongy.”
The easiest solution is to stick to a single column and make your emails fluid. This means that as the viewport shrinks, your content area shrinks.
.container max-width: 600px; width: 100%;
Responsive and Adaptive Link
Using media queries and breakpoints, we can provide alternate styles for different-sized viewports. We can also hide or show elements.
This starts to get complicated once you introduce a grid and columns. You could have a two-column layout and then switch to a stacked one-column layout below a certain viewport width.
But, as we’ve seen, media queries aren’t supported everywhere, so this isn’t always reliable.
Hybrid and Spongy Link
This technique uses a bit of fluid, a bit of responsive and a couple of hacks for Outlook support. We also get to ensure that the columns stack without media queries.......
@media only screen and (max-width: 620px) .span-3 max-width: none !important; width: 100% !important; .span-3 > table max-width: 100% !important; width: 100% !important;
Take a look at Fabio Carneiro’s spongy open-source repository83 on GitHub and read Stig’s take on coding mobile-first emails84. Rémi Parmentier also has another responsive technique85 that doesn’t need media queries and makes use of
Responsive Images Link
As mentioned, use Retina images at 1.5× to 3×, and set image dimensions inline.
We can’t rely on
max-width: 100%;because some clients ignore it. You will also want to embed the following CSS:
@media only screen and (max-width: 620px) img height: auto !important; max-width: 100% !important; width: auto !important;
Automating Your Workflow Link
The process of putting together a bulletproof email is complex. There are a lot of steps, and there is room for a lot of things to go wrong.
Like any monotonous task with steps, I recommend automating what you can, so that you build the system once and make it easier for future work.
Brian Graves has a good post on making your email modular86. Just as you have a design system and pattern library for a website or application, you should do so for email, making components reusable and emails consistent across your product and company.
Kevin Mandeville recommends using snippets of reusable code87 to optimize your workflow, so that you’re not constantly rewriting code. In his post, he outlines how to use snippets in modern editors (such as Atom and Sublime), and he points to the community-contributed library of snippets88 hosted by Litmus.
For my own part, I’ve put together and open-sourced a Grunt workflow for automating email builds89. It runs various tasks, such as inlining CSS, compressing images, uploading images to a CDN, sending a preview, and testing with Litmus, all with one command. If you’re new to Grunt, I’ve written a detailed tutorial90 on how it works. Foundation for Email91 also has some great automation tools for developers, as does Mailjet with its responsive email framework MJML92.
Looking To The Future Link
Google just recently rolled out support for media queries94; Microsoft has just partnered with Litmus95 to “make email better”; and AOL’s Alto now supports responsive email96. So, the future is looking much brighter.
97More and more companies and developers are experimenting with what’s possible with email technology: CSS animation98, audio99, shopping carts in email100. Expect more instances of interactive and kinetic email101 emerge in 2017.
Email design and development is a beast. It is a lot like building a web page… 10 years ago. Email client vendors haven’t been as progressive as web browser vendors in adopting new standards, and we users and companies don’t adopt new email clients like we do with web browsers. Add to that the rise of mobile, and we’re left in this state of having to support a convoluted mix of clients and versions.
My introduction here is a high-level overview; you could dive deep into every one of these points. Hopefully, it’s given you good insight into the world of building and sending email, and the code snippets and resources have added some hours back to your life.
Recommended Resources Link
Blogs to Follow Link
(il, vf, al)
- 1 http://www.mailgun.com/
- 2 https://www.campaignmonitor.com
- 3 http://mailchimp.com
- 4 http://myemma.com/
- 5 https://www.constantcontact.com
- 6 http://mailgun.com
- 7 http://sendgrid.com
- 8 https://postmarkapp.com/
- 9 http://sendwithus.com
- 10 http://www.postfix.org/
- 11 http://intercom.io
- 12 http://customer.io
- 13 https://www.drip.co/
- 14 https://www.getvero.com/
- 15 https://convertkit.com/
- 16 http://www.senderbase.org/
- 17 https://www.smashingmagazine.com/wp-content/uploads/2016/11/2-spam-large-opt.png
- 18 https://hackernoon.com/the-100-correct-way-to-validate-email-addresses-7c4818f24643#.i22l0u4ny
- 19 https://www.smashingmagazine.com/wp-content/uploads/2016/11/3-confirm-large-opt.png
- 20 http://en.wikipedia.org/wiki/CAN-SPAM_Act_of_2003
- 21 https://www.smashingmagazine.com/wp-content/uploads/2016/11/4-canspam-large-opt.png
- 22 http://kb.mailchimp.com/accounts/compliance-tips/terms-of-use-and-anti-spam-requirements-for-campaigns
- 23 https://medium.com/@chelucas/email-quality-score-explained-137d0871b4b5#.9uz3pyxny
- 24 https://ga-dev-tools.appspot.com/campaign-url-builder/
- 25 https://senderscore.org/
- 26 http://en.wikipedia.org/wiki/DomainKeys_Identified_Mail
- 27 http://en.wikipedia.org/wiki/Sender_Policy_Framework
- 28 https://www.smashingmagazine.com/wp-content/uploads/2016/11/5-score-large-opt.png
- 29 http://emailclientmarketshare.com/
- 30 https://litmus.com/community/templates
- 31 https://github.com/leemunroe/responsive-html-email-template
- 32 https://htmlemail.io/
- 33 http://foundation.zurb.com/emails.html
- 34 https://gsuite-developers.googleblog.com/2016/09/your-emails-optimized-for-every-screen-with-responsive-design.html
- 35 https://developers.google.com/gmail/design/reference/supported_css
- 36 https://github.com/premailer/premailer#premailer-specific-css
- 37 https://www.smashingmagazine.com/wp-content/uploads/2016/11/6-inline-large-opt.png
- 38 http://www.hongkiat.com/blog/sublime-code-snippets/
- 39 http://blog.teamtreehouse.com/handlebars-js-part-2-partials-and-helpers
- 40 http://inliner.cm/
- 41 http://templates.mailchimp.com/resources/inline-css/
- 42 http://foundation.zurb.com/emails/inliner.html
- 43 https://github.com/Automattic/juice
- 44 https://github.com/premailer/premailer
- 45 https://github.com/Mange/roadie
- 46 https://litmus.com/builder/ac11b59
- 47 https://litmus.com/builder/ac11b59
- 48 https://msdn.microsoft.com/library/hh801223
- 49 http://www.emailmonks.com/blog/email-marketing/creative-use-of-alt-text-in-email-learn-more-with-our-easter-campaign/
- 50 https://www.smashingmagazine.com/wp-content/uploads/2016/11/7-images-large-opt.jpg
- 51 http://cloudinary.com/
- 52 https://www.imgix.com/
- 53 https://css-tricks.com/a-guide-on-svg-support-in-email/
- 54 http://www.leemunroe.com/designing-for-high-resolution-retina-displays/
- 55 https://www.emailonacid.com/blog/details/C13/a_how_to_guide_to_embedding_html5_video_in_email
- 56 https://litmus.com/blog/how-to-code-html5-video-background-in-email
- 57 https://www.campaignmonitor.com/resources/guides/email-forms/
- 58 https://www.rebelmail.com/
- 59 https://mixmax.com/
- 60 https://developers.google.com/gmail/markup/actions/actions-overview
- 61 https://www.smashingmagazine.com/wp-content/uploads/2016/11/8-actions-large-opt.png
- 62 https://developers.google.com/gmail/markup/actions/declaring-actions
- 63 https://developers.google.com/gmail/markup/registering-with-google
- 64 http://codepen.io/awoodall/full/XbpMbo/
- 65 https://litmus.com/
- 66 https://www.emailonacid.com/
- 67 https://www.smashingmagazine.com/wp-content/uploads/2016/11/9-litmus-large-opt.png
- 68 https://putsmail.com/
- 69 https://www.mozilla.org/en-US/thunderbird/
- 70 https://en.wikipedia.org/wiki/Media_type
- 71 https://www.smashingmagazine.com/wp-content/uploads/2016/11/12-mime-large-opt.png
- 72 http://badbodymagazine.com/wp-content/uploads/2017/01/an-introduction-to-building-and-sending-html-email-for-web-developers.gif
- 73 https://litmus.com/blog/how-to-send-hidden-version-email-apple-watch
- 74 http://blog.rebelmail.com/accessibility-in-email-part-ii/
- 75 http://www.emailmonday.com/mobile-email-usage-statistics
- 76 http://emailclientmarketshare.com/
- 77 https://mailchimp.com/resources/research/impact-of-mobile-use-on-email-engagement/
- 78 http://alistapart.com/article/responsive-web-design
- 79 https://gmail.googleblog.com/2016/09/better-emails-tailored-to-all-your-devices.html
- 80 http://labs.actionrocket.co/the-hybrid-coding-approach
- 81 http://webdesign.tutsplus.com/tutorials/creating-a-future-proof-responsive-email-without-media-queries--cms-23919
- 82 https://www.smashingmagazine.com/wp-content/uploads/2016/11/14-responsive-large-opt.png
- 83 https://github.com/fcarneiro/tedc15_template
- 84 https://medium.com/cm-engineering/coding-mobile-first-emails-1513ac4673e#.nbpmobgvq
- 85 https://medium.freecodecamp.com/the-fab-four-technique-to-create-responsive-emails-without-media-queries-baf11fdfa848#.j6lqi5axh
- 86 https://www.smashingmagazine.com/2014/08/improve-your-email-workflow-with-modular-design/
- 87 https://litmus.com/blog/the-ultimate-guide-to-using-snippets-in-email-design
- 88 https://litmus.com/community/snippets
- 89 https://github.com/leemunroe/grunt-email-workflow
- 90 https://webdesign.tutsplus.com/tutorials/using-grunt-to-make-your-email-design-workflow-fun-again--cms-22223
- 91 http://foundation.zurb.com/emails.html
- 92 https://mjml.io/
- 93 http://badbodymagazine.com/wp-content/uploads/2017/01/an-introduction-to-building-and-sending-html-email-for-web-developers-1.jpg
- 94 https://gsuite-developers.googleblog.com/2016/09/your-emails-optimized-for-every-screen-with-responsive-design.html
- 95 https://litmus.com/blog/litmus-and-microsoft-partner-to-make-email-better
- 96 https://twitter.com/M_J_Robbins/status/679639156868431872
- 97 https://www.smashingmagazine.com/wp-content/uploads/2016/11/11-geo-large-opt.gif
- 98 http://apps.balloondog.co.uk/emails/disney/WOE/production/
- 99 http://actionrocket.cmail20.com/t/ViewEmail/j/499D33718086CE64/2696DD450C6A11ABA0F01D70678E0DEE
- 100 https://www.webdesignerdepot.com/2015/10/punched-card-coding-the-secret-of-interactive-email/
- 101 http://freshinbox.com/blog/the-dawn-of-kinetic-email/
- 102 https://github.com/leemunroe/responsive-html-email-template
- 103 http://professionalemaildesign.com/
- 104 https://www.codeschool.com/courses/unmasking-html-emails
- 105 http://reallygoodemails.com/
- 106 http://freshinbox.com/resources/techniques.php
- 107 https://www.campaignmonitor.com/guides/
- 108 http://mailchimp.com/resources/
- 109 https://litmus.com/blog/
- 110 https://www.emailonacid.com/blog