Download htmlmail-7.x-2.x-dev.tar.gztar.gz 27.55 KB
MD5: 5c31ded9922175fbed58f1890fabdc14
SHA-1: 3c8b6db4fd60070068a7e4c1ea32219f67b3d2f5
SHA-256: 2691cadbbecfb4453bfcc43c526b6bb20fc0d7e4f9075cb70d6cb45a90f8289f
Download htmlmail-7.x-2.x-dev.zipzip 40.99 KB
MD5: e6b7e0e0b6f8855a8a8f44f109e37922
SHA-1: 46c33fc8c158807b076bccfe1fc9c617d744911b
SHA-256: 61c15e49980b4bc3dd72e32c3ab9faa25786a020f9fe74cbd51ef54f75530e5a
Install with Composer: $ composer require 'drupal/htmlmail:2.x-dev'
Using Composer to manage Drupal site dependencies

Release info

Created by: pillarsdotnet
Created on: 26 Mar 2011 at 04:46 UTC
Last updated: 11 Apr 2017 at 22:34 UTC
Core compatibility: 7.x
Release type: Bug fixes, New features

Release notes


Lets you theme your outgoing messages the same way you theme the rest of your website.



The following additional modules, while not required, are highly recommended:

  • Echo
    Wraps your messages in a drupal theme. Now you can "brand" your messages with the same logo, header, fonts, and styles as your website.
  • Emogrifier
    Converts stylesheets to inline style rules, for consistent display on mobile devices and webmail.
  • Mail MIME
    Provides a text/plain alternative to text/html emails, and automatically converts image references to inline image attachments.
  • Pathologic
    Converts urls from relative to absolute, so clickable links in your email messages work as intended.
  • Transliteration

    Converts non-ASCII characters to their US-ASCII equivalents, such as from Microsoft "smart-quotes" to regular quotes.

    Also available as a patch.


Visit the Mail System settings page at admin/config/system/mailsystem to select which parts of Drupal will use HTML Mail instead of the default mail system.

Visit the HTML Mail settings page at admin/config/system/htmlmail to select a theme and post-filter for your messages.


The email message text goes through three transformations before sending:

  1. Template File

    A template file is applied to your message header, subject, and body text. The default template is the included htmlmail.tpl.php file. You may copy this file to your email theme directory (selected below), and use it to customize the contents and formatting of your messages. The comments within that file contain complete documentation on its usage.

  2. Theming

    You may choose a theme that will hold your templates from Step 1 above. If the Echo module.) is installed, this theme will also be used to wrap your templated text in a webpage. You use any one of over 800 themes to style your messages, or create your own for even more power and flexibility.

  3. Post-filtering

    You may choose a text format to be used for filtering email messages after theming. This allows you to use any combination of over 200 filter modules to make final changes to your message before sending.

    Here is a recommended configuration:

    • Emogrifier Converts stylesheets to inline style rules for consistent display on mobile devices and webmail.

    • Transliteration Converts non-ASCII text to US-ASCII equivalents. This helps prevent Microsoft "smart-quotes" from appearing as question-marks in Mozilla Thunderbird.

    • Pathologic Converts relative URLS to absolute URLS so that clickable links in your message will work as intended.


Visit the issue queue for support and feature requests.

Related Modules



HTML Purifier



Mail System






Installing contributed modules


Theming guide

Original Author

Current Maintainer


The selected release is the release that will be used for automated testing. Optional projects are only used for testing.



No optional projects