About HTML Email
This page is now available in other languages.
English
Español
Français
Português
Deutsch
If Mailchimp's templates don't suit your needs, you can custom code your own HTML email. In this article, you'll learn about HTML email, and you'll find guidelines for creating your own HTML template in Mailchimp.
Multipart email delivery
A critical step in creating HTML is making sure what you've designed and coded shows up in your subscribers' inboxes. Even if your HTML email displays like you want in your own email program, some recipients aren't able to view HTML email in their email programs.
In addition to your HTML, you should send a plain-text alternative version of your message for those people who can't view HTML emails. When a recipient receives your email, their email program will automatically determine which format to display.
Multipart/Alternative MIME format sends both the HTML and plain-text versions of an email. Mailchimp automatically creates a plain-text version of a campaign, and also works alongside internet service providers (ISPs) and anti-spam groups to ensure the best delivery possible.
Fundamental principles
Keep it simple.
Focus on your message.
Post images on a publicly accessible web server.
Use absolute paths in your code when you embed images or link to files. Make sure your assets are hosted on a publicly accessible server, so your recipients can see the images or download the files. Avoid free hosting sites, too, because these often have bandwidth limits that may prevent your images from displaying.
Use tables and shim.gifs.
Keep the code simple. All email programs use different methods to render HTML, like Internet Explorer, Microsoft Word, or their own proprietary renderer, so more high-level coding may not display as intended.
Set email width to 600px or less.
Most people view messages in their preview panes, which are narrow and small. The templates we design at Mailchimp are never more than 600 pixels wide, or they're fluid-width.
Test how it renders.
Because all email programs render HTML differently, test your HTML email on different email programs. You can also use Inbox Preview to test how your email renders in major programs.
Webmail services strip certain elements.
Browser-based email services like Gmail, Yahoo, and Hotmail strip out your DOCTYPE, BODY, and HEAD tags, so your code doesn't override theirs. Anything you'd normally code inside those tags (background colors, embedded CSS, JavaScript, background music files, etc.) will be removed. Use inline CSS and FONT tags. Mailchimp offers a CSS inliner tool to help with this.
Think like a spam filter.
Consider spam filters and spam firewalls when you code.
Email open tracking
Open-tracking functionality is built into email marketing solutions like Mailchimp, so you don't have to do anything. But it helps to know how it works.
Opens are generally tracked by inserting a tiny, transparent graphic at the bottom of the message. When the tracker image is downloaded from the server after a recipient opens the email, we count it as an open.
Because plain-text emails don't contain images, open tracking is handled differently. Mailchimp lets you enable click-tracking in your plain-text emails, so when someone clicks a link in their plain-text email, we track that as an open and a click.
To track clicks, Mailchimp automatically converts all links in your emails to point to our redirect scripts. When a recipient clicks your link, they're redirected from our server to your original URL, and we track the click. That helps us generate campaign reports that tell you which links your recipients clicked most.
Audience management
Use good audience-management practices to avoid being denylisted (other providers may refer to it as "blacklisted") by ISPs and anti-spam groups.
Here are a few tips for managing your audiences.
Don't send marketing emails to anyone who hasn't given you permission.
Some emails will bounce. There are two bounce types: a soft bounce means the recipient was temporarily unavailable, and a hard bounce means the email was undeliverable. Remove hard bounces immediately, because if you keep sending emails to a server after it has told you the email doesn't exist, they may block your future messages.
If an email soft bounces three campaigns in a row, it's best practice to clean it from your audience. If you send daily emails, you may want to wait longer to see if the bounce reason is resolved.
Unsubscribe requests should be handled immediately.
You can customize the signup form and opt-in process to match your branding, or use our API to pass opt-in data directly from your website to Mailchimp.