5 ms·

The email boilerplate for sending out nicely formatted messages

88 points by tilt 14y ago

Jgrubb 14y ago
Thank god. Crafting HTML email is a thankless job IMO, and Googling for tips/help/pointers/bugfixes always makes me feel like Wall-E trying to sort through mountains of marketing spam for some actual technical help.
bjourne 14y ago
I love this! At a few previous workplaces I could have put this project to good use in our mail delivery system. But it is still a testament to the huge difference between doing something and doing something right. Uninformed people just don't get how hard it actually is to send mail. Especially if you have a large distribution list and it is important that your mail does not get caught in over-zealous spam filters. Those people you can point to this project to prove that it takes time and effort to do something as seemingly simple as mailing right. It is the same with i18n. You can't just i18n:ize a site by storing the text translations in the database and showing the right translation based on the browsers Accept-Language header. It becomes a hugely more complex issue when you consider stuff like search engines, date formatting, currency formatting, whether sunday is the start of the week or not and so on.
- hammock 14y ago
  What are some tips to keep your emails from getting caught in over-zealous spam filters?
  - Paul_S 14y ago
    If you send a plaintext email that is more than just a link to a dodgy domain you are guaranteed to get through (unless you're already on a blacklist). This is the only kind of spam I still get. Even spammers know to use plaintext (well, some)!
    - bjourne 14y ago
      Well, yes, mostly. But you also want your email to be read, not only delivered. Your email mail also contain some kind of CTA (call-to-action, website to visit and so on...) which you are trying to get the reader to respond to. Those numbers may be higher with well designed "beautiful" html mails than plain text ones. Lastly, you may want to measure how many people actually opens and reads your mail and when they do it, instead of just letting it languish in your inbox. It's trivial to do by embedding tracking pixels in the html mail, but impossible in plain text ones. Personally, I abhor html mails like the plague, and the people who believe that bold facing or underlining some text somehow makes it easier to decipher some meaning from the text, but they do have a purpose. Mostly for marketing purposes I admit.
  - tomwalsham 14y ago
    Email deliverability these days is heavily based on sending IP reputation, to a lesser extent domain reputation, and finally content. Once you have ticked the core boxes of compliance - clean html in your templates, never send just HTML email but use multipart with plaintext, be sure of your MTA's RFC compliance, sign with DKIM/SPF - then reputation now strongly hinges on recipient behaviour at the largest ISPs. Marking an email as Spam is an obvious flag, but additional heuristics such as open rate, clicks, deletes etc. are used to determine your relationship with that recipient, and your reputation over time. The most common issues these days with content-based filters come from smaller independently run installs - SpamAssassin, ASSP etc. As a legitimate sender you can usually cover inbox delivery to 90% of recipients by building a solid reputation on your IP with the large ISPs. The final 10% will be related to content, linked domains etc. at the smaller services. A large reason for the growth in email-as-a-service platforms is the reputation component is already taken care of, and you can focus on content and engagement instead of the finicky aspects of core email delivery.
laurencei 14y ago
wow - I've looking for this exact thing - so hard doing email templates for my various apps - thanks
- eli 14y ago
  Mailchimp has some decent ones for free http://mailchimp.com/resources/html-email-templates/ http://mailchimp.com/resources/html-email-templates/ (it should be easy to adapt them for other email providers)
- patio11 14y ago
  I generally just buy something on ThemeForest for ~$2 and then increase the font size. (What is it with designers and 11pt fonts, anyhow?)
tehabe 14y ago
The only advice on HTML in e-mail should be: don't!
- eli 14y ago
  I think you lost that battle like 15 years ago
  - Paul_S 14y ago
    Nah, if someone sends me HTML it gets parsed into plaintext and if it doesn't work I don't care what's in it. You want to send me a pretty document - feel free to send me an attachment or a link. HTML emails are always ridden with superfluous disclaimers and signatures not using the -- convention, they're a waste of time.
    - eli 14y ago
      I got absolutely no problem with that, I just don't think you're going to win many converts.
    - JoeAltmaier 14y ago
      Use them to send embedded screen captures at work. Could be an attachment, but then its hard to put into context.
    - ldh 14y ago
      I sympathize, but I'd much rather somebody send me an HTML email than an attached Word document, which is the next likely candidate in most workplaces.
  - mbateman 14y ago
    You may have to parse HTML email, but you don't have to send it.
- brlewis 14y ago
  There are valid uses. My hybrid photo-sharing/blogging service lets you send an email update with thumbnails inline, so you can tell family/friends about your latest doings without making them click a link out. http://ourdoings.com/ http://ourdoings.com/ I suppose you could generalize this by saying HTML email is useful when you have images that are informational, not just decorative.
Daviey 14y ago
ugh.. HTML mail.. If this makes it easier for people to write good looking (or bad) HTML mail, then it's a broken objective. Plain text mail please!
eli 14y ago
Note that the website has a nice explanation: http://htmlemailboilerplate.com/ http://htmlemailboilerplate.com/
michaelmior 14y ago
Anyone interested in this may also wish to check out MailChimp's templates http://mailchimp.com/resources/html-email-templates/ http://mailchimp.com/resources/html-email-templates/
fleaflicker 14y ago
Does anybody have screenshots of what this looks like in the popular email clients? Also, this was previously discussed here: http://news.ycombinator.com/item?id=2628945 http://news.ycombinator.com/item?id=2628945

88 points by tilt 14y ago

Thank god. Crafting HTML email is a thankless job IMO, and Googling for tips/help/pointers/bugfixes always makes me feel like Wall-E trying to sort through mountains of marketing spam for some actual technical help.

bjourne 14y ago

I love this! At a few previous workplaces I could have put this project to good use in our mail delivery system. But it is still a testament to the huge difference between doing something and doing something right. Uninformed people just don't get how hard it actually is to send mail. Especially if you have a large distribution list and it is important that your mail does not get caught in over-zealous spam filters. Those people you can point to this project to prove that it takes time and effort to do something as seemingly simple as mailing right. It is the same with i18n. You can't just i18n:ize a site by storing the text translations in the database and showing the right translation based on the browsers Accept-Language header. It becomes a hugely more complex issue when you consider stuff like search engines, date formatting, currency formatting, whether sunday is the start of the week or not and so on.

hammock 14y ago
What are some tips to keep your emails from getting caught in over-zealous spam filters?
- Paul_S 14y ago
  If you send a plaintext email that is more than just a link to a dodgy domain you are guaranteed to get through (unless you're already on a blacklist). This is the only kind of spam I still get. Even spammers know to use plaintext (well, some)!
  - bjourne 14y ago
    Well, yes, mostly. But you also want your email to be read, not only delivered. Your email mail also contain some kind of CTA (call-to-action, website to visit and so on...) which you are trying to get the reader to respond to. Those numbers may be higher with well designed "beautiful" html mails than plain text ones. Lastly, you may want to measure how many people actually opens and reads your mail and when they do it, instead of just letting it languish in your inbox. It's trivial to do by embedding tracking pixels in the html mail, but impossible in plain text ones. Personally, I abhor html mails like the plague, and the people who believe that bold facing or underlining some text somehow makes it easier to decipher some meaning from the text, but they do have a purpose. Mostly for marketing purposes I admit.
- tomwalsham 14y ago
  Email deliverability these days is heavily based on sending IP reputation, to a lesser extent domain reputation, and finally content. Once you have ticked the core boxes of compliance - clean html in your templates, never send just HTML email but use multipart with plaintext, be sure of your MTA's RFC compliance, sign with DKIM/SPF - then reputation now strongly hinges on recipient behaviour at the largest ISPs. Marking an email as Spam is an obvious flag, but additional heuristics such as open rate, clicks, deletes etc. are used to determine your relationship with that recipient, and your reputation over time. The most common issues these days with content-based filters come from smaller independently run installs - SpamAssassin, ASSP etc. As a legitimate sender you can usually cover inbox delivery to 90% of recipients by building a solid reputation on your IP with the large ISPs. The final 10% will be related to content, linked domains etc. at the smaller services. A large reason for the growth in email-as-a-service platforms is the reputation component is already taken care of, and you can focus on content and engagement instead of the finicky aspects of core email delivery.

laurencei 14y ago

wow - I've looking for this exact thing - so hard doing email templates for my various apps - thanks

eli 14y ago
Mailchimp has some decent ones for free http://mailchimp.com/resources/html-email-templates/ http://mailchimp.com/resources/html-email-templates/ (it should be easy to adapt them for other email providers)
patio11 14y ago
I generally just buy something on ThemeForest for ~$2 and then increase the font size. (What is it with designers and 11pt fonts, anyhow?)

tehabe 14y ago

The only advice on HTML in e-mail should be: don't!

eli 14y ago
I think you lost that battle like 15 years ago
- Paul_S 14y ago
  Nah, if someone sends me HTML it gets parsed into plaintext and if it doesn't work I don't care what's in it. You want to send me a pretty document - feel free to send me an attachment or a link. HTML emails are always ridden with superfluous disclaimers and signatures not using the -- convention, they're a waste of time.
  - eli 14y ago
    I got absolutely no problem with that, I just don't think you're going to win many converts.
  - JoeAltmaier 14y ago
    Use them to send embedded screen captures at work. Could be an attachment, but then its hard to put into context.
  - ldh 14y ago
    I sympathize, but I'd much rather somebody send me an HTML email than an attached Word document, which is the next likely candidate in most workplaces.
- mbateman 14y ago
  You may have to parse HTML email, but you don't have to send it.
brlewis 14y ago
There are valid uses. My hybrid photo-sharing/blogging service lets you send an email update with thumbnails inline, so you can tell family/friends about your latest doings without making them click a link out. http://ourdoings.com/ http://ourdoings.com/ I suppose you could generalize this by saying HTML email is useful when you have images that are informational, not just decorative.

Daviey 14y ago

ugh.. HTML mail.. If this makes it easier for people to write good looking (or bad) HTML mail, then it's a broken objective. Plain text mail please!

eli 14y ago

Note that the website has a nice explanation: http://htmlemailboilerplate.com/ http://htmlemailboilerplate.com/

michaelmior 14y ago

Anyone interested in this may also wish to check out MailChimp's templates http://mailchimp.com/resources/html-email-templates/ http://mailchimp.com/resources/html-email-templates/

fleaflicker 14y ago

Does anybody have screenshots of what this looks like in the popular email clients? Also, this was previously discussed here: http://news.ycombinator.com/item?id=2628945 http://news.ycombinator.com/item?id=2628945