Build an HTML Email Template From Scratch | How To

Final product image
What You’ll Be Creating

The best way to understand any process is to carry it out yourself, from the ground up. Today, we’re going to do just that with email design, by building an HTML email from scratch.

Editor’s note: this tutorial was originally written by Nicole in June 2013. Since then it’s become the go-to reference for industry leaders all over the world, and has been used by millions of beginners as a starting point for their adventures in email. It’s as relevant today as it was when it was first published.

Popular Email Templates on Envato Elements

If you’re looking for a ready-made, professional solution, grab one of our best email templates. We have hundreds of responsive options on Envato Elements, with easy to customize features to get you started.

Popular email templates on Envato Elements
Popular email templates, available (unlimited use) on Envato Elements

Not what you’re looking for? No problem, this tutorial will teach you how to your own.

Kick Things Off

To begin with, it’s worth mentioning where I pulled some of the resources from.

  • The lovely 2D icons are by Pierre Borodin on Dribbble
  • The typefaces used are Oil Can, Source Sans Pro and Mission Script
  • The social media icons are from Metrize Icons

Now, as we discussed in the previous tutorial, you’ll need to begin your HTML email document with an XHTML doctype:

With that sorted, we can commence building the rest of the structure.

Creating the Body and Main Table

First, we’ll add an overall structure for our email, starting with a tag. We’ll set the margin and padding on the body tag to zero to avoid any unexpected space.

We’ll also add a table with a width of 100%. This acts as a true body tag for our email, because styling of the body tag isn’t fully supported. If you wanted to add a background color to the ‘body’ of your email, you’d need to apply it to this big table instead.

Set your cellpadding and cellspacing to zero to avoid any unexpected space in the table.

Note: We’re going to leave border="1" on all of our tables, so that we can see the skeleton of our layout as we go. We’ll remove them at the end with a simple Find & Replace.

Our first HTML email layout section

“If an attribute exists in HTML, use that instead of CSS”

Now place a centered table of 600 pixels wide inside the container table. 600 pixels is a safe maximum width for your emails to display comfortably within most desktop and webmail clients on most screen resolutions.

Set this width using HTML instead of CSS, by using the width attribute. The golden rule in HTML email development is: if an attribute exists in HTML, use that instead of CSS.

We’ll replace our little ‘Hello!’ greeting with this table:

We’ve also added an inline style property that sets the border-collapse property to collapse. If we don’t do this, newer versions of Outlook will add a small space between our table and our border.

The container table for our HTML email layout

Creating the Structure and Header

In our design we can see that the email is divided into three logical sections, so we’ll create a row for each.

Let’s duplicate the single row we already made so that we have three in total. I’ve changed the text inside them so that we can easily identify each row.

Extra rows in our HTML email layout

Now we’ll color them according to the design. As bgcolor is a valid HTML attribute, we’ll use that to set the background color instead of CSS. Always remember to use the full six characters of a hex code, as three character shorthand won’t always work.

Colored rows

Ok, next up we are going to focus on Row 1. We want to adjust the padding on the cell and then insert our image.

Using Padding

When using padding in email, you must always specify every single value (top, right, bottom and left) otherwise you can get unpredictable results. I find that you can still use the shorthand, i.e. padding: 10px 10px 8px 5px;, but if you are having trouble you may wish to write it out longform, i.e. padding-top: 10px; padding-right: 10px; padding-bottom: 8px; padding-left: 5px;.

If you are having even greater troubles with padding (for example, if your send platform is stripping out your CSS), don’t use it at all. Simply use empty cells to create space. There is no need to use spacer GIFs, just make sure you add style="line-height: 0; font-size: 0;" to the cell, place an   inside and give it an explicit height or width. Here is an example:

Also note that it’s safe to use padding on TD tags but not on P tags or DIVs. They behave a lot more unpredictably.

So, we’ll use some inline CSS to add padding to the cell. Then we’ll insert our image, adding alt text and adding style="display:block;" which is a common fix that stops some email clients adding gaps underneath your images. We’ll center the image by adding align="center" to our td tag. We’ll also add an alt tag which is important for when our email is initially loaded which, in most cases, will be with images off.

Note: If the contents of your header are really important to your message, don’t use an image-only header. Remember, images are blocked by default for most clients, so if there is an aspect of your email that is crucial, never include it as an image. In this example, however, my header is pretty superfluous.

The email header along with image

Creating the Content Area

First off, we’ll add some padding to the middle cell so that the table inside has some space around it, as per our design.

Added padding to the middle cell

Now we’ll add a table with three rows for our main content–one for the headline, one for the introductory text, and one for the row with two columns. We’ll set the width of this table to 100% rather than using a pixel value because this will help us further down the track if we want to make our email responsive. If you always have pixel widths on everything, you can end up with a lot of values to override with media queries. If your nested table widths are based on percentages, then when you adjust the width of the parent element, everything will adapt accordingly.

Three nested rows for our main content

Now we’ll add in our content, and add some padding to the middle cell.

Added content and padding for middle cell
Lorem ipsum dolor sit amet!
Lorem ipsum dolor sit amet, consectetur adipiscing elit. In tempus adipiscing felis, sit amet blandit ipsum volutpat sed. Morbi porttitor, eget accumsan dictum, nisi libero ultricies ipsum, in posuere mauris neque at erat.
Row 3

Now we are going to add our two columns of content to Row 3. Because we want a ‘margin’ in between these two cells, but margin isn’t supported, we’ll create a three-column table with an empty cell between the two outer columns.

As much as I like to stick to percentages, when you have content that is a specific size, it can be tricky to convert it to a percentage (in this example, the columns would be 48.1% which could become confusing). For this reason, since our two images are 260px wide, we’ll create columns that are also 260px wide, with a 20px margin cell in the middle. (This will total 540px, which is the 600px width of our table minus the padding of 30px on either side.) Be sure to zero your font-size and line-height and add a a non-breaking space character   in the margin cell.

We’ll also set the valign to top for both cells so that they will vertically align to the top, even if one column has more text than the other. The default vertical alignment is middle.

Two columns to content row three

Now let’s add our images and content to those columns. As we need multiple rows, we’ll nest yet another table because we can’t use any colspan or rowspan tags. We’ll also add some padding in between the image and copy in each column.

Lorem ipsum dolor sit amet, consectetur adipiscing elit. In tempus adipiscing felis, sit amet blandit ipsum volutpat sed. Morbi porttitor, eget accumsan dictum, nisi libero ultricies ipsum, in posuere mauris neque at erat.
 
Lorem ipsum dolor sit amet, consectetur adipiscing elit. In tempus adipiscing felis, sit amet blandit ipsum volutpat sed. Morbi porttitor, eget accumsan dictum, nisi libero ultricies ipsum, in posuere mauris neque at erat.

Here we have set the width of the images using HTML at 100% of the column width. This, again, is so that if we make this email responsive, we only have to use media queries to change the width of the parent element. We’ll have to override the height in pixels because using style="height: auto" now won’t work in everything (cough cough, Outlook). So we’ll set it using pixels. This means we’d have to set height: auto!important on those images using media queries to override the pixel value, but we could do that with a single class. As we set the width as a percentage, we won’t need to override that. The fewer things to override, the better.

Images in the columns

The Footer

Now we’ll add our padding to the footer row.

Padding to the footer row

Inside that cell, we’ll nest another table to get our two columns.

Two columns for the footer

We’ll create another little table for our social media icons. We’ll set its parent cell to align="right". Make sure you set border="0" on these image links (to avoid a blue link border) and don’t forget display:block.

Table for social media icons

Now we’ll add our text and add a width to our cells, just to be safe, even though there is a lot of whitespace between them. We’ll set this cell to 75% and the other to 25%.

And there we have it! Our layout is complete.

Validation

Let’s run this through the W3C Validator to make sure nothing is bad or broken. If you’ve followed along exactly, it will say that it has passed.

email-build-valid

Next we’re going to run a test through Litmus to make sure the structure of our email works great. Here’s a summary of my test:

litmus email results
Take a look online

Styling Our Text

Our first row is the heading. We’ll use the tag to create bold text because, as we already know, if it exists in HTML, we use that instead of CSS.

We’ll also add this inline style to all the other cells of text:

Next we need to style the footer text, and we’ll also tidy up our unsubscribe link. We’ll style our unsubscribe text link using both CSS and the HTML tag. This doubling up is the best way to ensure that your links never show up in the default blue.

Almost there

And there we have it! Everything is in. Time to turn off the borders and see it looking beautiful. Go through and replace every occurance of border="1" with border="0".

Borders turned off

At this point, it’s looking a little sad floating in white space, so let’s go up to our first 600px wide table and add:

Now it doesn’t look like it’s floating anymore. As a final touch, I’m going to add 30px of padding to the bottom of the very first cell, to prevent our email from stopping abruptly at the bottom in some webmail clients (like Apple Mail), and 10px of padding at the top, so that our blue header has a little bit of breathing room.

You might also like
Leave A Reply

Your email address will not be published.