Onboarding: Emails

The vast majority of marketers today rely on email as their primary channel for communication with prospects and customers. While Mautic supports incorporating other channels into campaigns, email has the most complexity. Before you build your messages, be sure you’ve set up your sender domains so Mautic can actually send them.

Email Types
Email Basics
Email Builder
A/B Testing

Email Types

Email Types

Template Email

Template emails are very versatile, with Mautic offering several ways for you to use them. Typically thought of as more transactional emails, users can designate a template email as a marketing email within a campaign.


To send a template email in a campaign, add a campaign action and select Send email. You’ll also see an option for Send email to user (see description below). Name the action, schedule the send time, and choose the email you’d like to send.

Form Submission

After a contact submits a form, you can automatically send a couple different kinds of emails from the Actions tab. Of course, you can send an email directly to the contact. You can also use template emails to send messages to team members who may benefit from form submission notifications. Select any one or more of Send email to contact, Send email to user, or Send form results. Standalone forms have all of these options available. However, Send email to contact does not appear on Campaign forms. In a Campaign form, you would simply add an action to send the email to the contact within the campaign. Similarly to the Campaign, give the action a title and select the email you want.

Point Trigger

Once a contact has reached a certain number of points, you can automatically send them some sort of email. Examples may include a special offer for your most engaged contacts, or a congratulations message for accumulating that point total. We also offer an option to Send email to user in the Point triggers. With this, you can notify an internal team member when a contact reaches a point value.

Send Email to User

For all of the Send email to user options, you’ll see a few additional options. These enable you to send notices to appropriate team members and know when a contact is receiving a certain message. Any tokens in those emails will be the tokens from the Contact’s record, not the user’s. You can use this effectively as a BCC, or create a different email to send to your team members.

Direct to Contact

The final way to send a Template email is directly from a contact record. On a contact page, look for the Send email option towards the top right corner, above the profile image. Select the template email you’d like to send at the bottom, and make any necessary changes in the editor. Changes to the From name and address or Subject line override the information on the email template.

Please note that if you send emails directly from a contact record, Mautic doesn’t track the stats on those messages for reporting. You will be able to see if a contact opens one of these emails.

Segment Email

Segment emails are marketing emails. Examples may include newsletters or general announcements. Sending a segment email is very straightforward. Simply create the content, select the segment(s) you want to receive the message, and schedule the send. To do that, click the Send button and enter the date and time you’d like the email to go out.

Once you’ve sent a segment email, Mautic won’t automatically send it to new contacts added to that Segment. Instead, you’ll see those added as “Pending,” and re-sending the email will only send it to those new contacts.

A contact can only receive a Segment email once. This means you can send it as many times as you need without the same contact getting a duplicate.

Email Basics



Mautic includes several themes out of the box. These themes are all editable, so you can choose your own colors, images, styles, and more. The most mobile-responsive and Outlook-friendly themes are Vibrant, Sparse, Aurora, and Cards.

We recommend that each customer create a custom theme, making branding more consistent with less effort on each new email. To get started with creating your own custom theme(s), please use our Introduction to Theming course.

Users may also select the Code Mode theme to write emails entirely in HTML.

Note: Once you’ve built an email, changing the theme will wipe out the content. We recommend creating a new email with the theme you want to switch to, then re-produce your content.

Sidebar Options

Email options

Subject: This is what your contacts will see in their inboxes.

Internal Name: The name displayed in your email list and selection menus for any Send email action. We recommend having some sort of naming convention for different types of emails you may send. A naming convention will help keep your list organized and help team members find emails easily.

Contact Segment (for Segment emails only): The audience you’ll send that email to.

Category: You can organize your emails based on their goals, campaigns, etc. Learn more about categories in our Global Categories help center topic.

LanguageIs a translation of: If you’re sending emails to contacts in multiple regions from a single Mautic instance, Mautic can identify those regions and send emails in the appropriate languages. However, you’ll need to create the content for each of those languages. Select the language you’re building the email in and the main email that you’re translating.

For example, if you mostly use English, you can create a French version to automatically send to contacts in France. Create the English version and label it as English, then create the French version. Add the French label, and select the English version in the Is a translation of box.

Publish options: The Yes/No toggle is the fastest way to publish or unpublish an email. If it’s unpublished, it won’t be sent. Particularly for template emails, the publish at and unpublish at date/time options can be critical. Set the beginning and/or end dates & times for the period you’d like the email to be active in these boxes. This helps control relevance, and prevents users from needing to manually publish or unpublish emails at exactly the right times.

Unsubscribe feedback form: If contacts are about to unsubscribe, you can present them with a feedback form. Analyzing and acting on the responses may help you create more relevant content and reduce your number of unsubscribes.

Preference Center page: Unsubscribes can hurt a marketer’s ego (and they mean fewer people to communicate with). The unsubscribe button doesn’t have to immediately shrink your list. A preference center lets your contacts tell you how they want you to communicate with them. Learn more on our Preference Center help center topic. Once you’ve created a Preference Center page (or multiple), choose the one you want attached to any particular email.

Google Analytics UTM tags: Mautic supports UTM tagging in emails and landing pages. Learn more about the value of UTM and how to use these tags in our UTM tags help center topic.

Advanced Tab

Email Advanced options

From name and address: These options determine how the email appears in your contacts’ inboxes. If you’re writing a message best suited to be coming “from” someone else, enter his or her information here.

Reply to address: If replies should go to a different mailbox than the “from” address, enter that mailbox here.

BCC address: To copy yourself or a specific address when an email gets sent, use this BCC field. Note: Our default delivery partner, Sparkpost, does not handle tokens in CC or BCC emails. As a result, Mautic converts the BCC to an additional “To” address. To use things like BCC to CRM or see exact copies, use “Send email to user” options.

Attachments: You may attach an asset that you’ve uploaded to Mautic to the email. Once it’s downloaded, you’ll have that event tracked for reporting, scoring, and more.

Plain text version: The plain text version strips out HTML when a recipient’s email service provider doesn’t accept HTML messages. You can either create one manually, or just click “Auto Generate” after you’ve created the content in the email builder. We highly recommend creating a plain text version to help with email deliverability.

Email Builder


Slot Types


This is the most versatile slot type in an email builder. If you wanted to, you could do just about anything you want in a text box. Once you have a text slot in your email, select it to see WYSIWYG editor on the right side.

Text slot

Inside this box, there are plenty of formatting options. In order that the icons appear (left to right, top row then bottom row): Bold, italics, underline, paragraph format (based on what’s in the theme you’re using), font family, font size, color (text and background options available once you click the droplet icon), alignment, numbered list, bulleted list, quote format (indentation), clear formatting, token menu, insert link, insert image, insert video, insert table, code mode, and view full screen.

Tokens in emails follow the format of {contactfield=field_alias}. You can find the field_alias by using the dropdown menu, or in the Custom Fields section of the Settings menu. If you’re using a company field, still use the same format. Mautic pulls the data from the contact’s primary company.

In order to track link clicks for reporting or for decisions in campaigns, be sure to use the hyperlink option. Using the shortcut CTRL+K or CMD+K works as well. Typing or copy/pasting a URL into the body of the email will not create a trackable link.

Text slots actually offer more flexibility for images than the image slot. We often see customers add images into text slots, either with or without text. Once you click the Image button, you’ll see a few options appear:

Email image options

The first icon is to upload an image. If you’d like to use a URL for an image, select the second icon. Finally, if you’re looking for an image you’ve previously uploaded, the third icon opens the file manager.

Using the video option enables you to include gated video in your emails. If you don’t want to gate the video, just paste in the URL for the video you want to use. If you do want it gated, enter the time to wait before a form appears and the form to use. Be sure to test this, as limited space causes forms to display differently in a video than on landing pages.

To make more advanced changes, you can use code mode within a text slot. Adjusting colors to a specific HEX code, paragraph styles and formatting, and even creating buttons are the most common uses for code mode in a text slot. When finished making changes in code mode, click the </> icon again to return to normal view before saving. Otherwise, your changes won’t be applied.


After dragging in an image slot, click the placeholder box to find options for the image.


The first icon is the Replace icon. Use this to add your image initially, or to change it later on.

Next is the alignment. You also have alignment options to the right of the preview window, in the Customize Slot section.

In the middle, you’ll find an “i” icon. That’s to add alternate text to an image, which is important to do to help with email deliverability. Typically, using whatever you’d name the image will do.

The fourth icon is to adjust the size. With this, you can change the width and height in pixels.

Finally, if you’d like to have the image act as a hyperlink, use the link icon and add your URL. Like you would when adding a text link, you have the option to open the link in a new tab.

Image Card

Image cards are very similar to the Image slot type. However, you’ll notice more options in the Customize Slot section in the editor panel (on the right). There, you can change the text for the caption, change alignment for the image and caption, and change colors for the image background, caption background, and caption text.

Click the “blank” placeholder box to find the options to add or replace the image, like in the Image slot.



A third image slot type, the only difference between this and the Image Card is background colors. The Image+Caption slot type does not include backgrounds.



In many cases, marketers want to have some sort of call to action in their emails and drive recipients to a certain page. The Button slot type is the most straightforward way to do that.

The Customize Slot area in the editor on the right gives options to change the border radius (curved edges instead of straight), adding custom text and a link, size, position, and colors for the button and text.

Social Follow

With this slot type, you can add links to follow your organization’s Google+, Facebook, and Twitter pages. All you need to do do is add the links for the social profiles you’d like to link to.

Code Mode

Code Mode

To create a slot entirely in HTML, drag in a code mode slot and write your code in the editor. You’ll be able to see the changes immediately in the main preview panel.



A very basic design element, this is a line that separates parts of your email.

Dynamic Content

Dynamic Content

Dynamic Content enables users to personalize the content of their emails beyond tokens. Editing these slots is just like editing a text slot, but with additional options for the content. Rather than creating multiple emails and multiple campaigns to send to different segments, dynamic content essentially segments within one email.

You’re able to build unlimited variants in the slot, using the Add Variant button in the top right corner of the editor. All you need to do is select the filter(s) below the WYSIWYG for the audience you’d like to see that slot.



Sections are the areas containing one or more slots. You can add sections with up to three columns, and have multiple slots within each section and/or column.

In the Customize Section editor, you’ll see a handful of options.

Section Editor

The Content Background Color is for the background within the area where you have content.

The Wrapper Background Color is for the rest of the background – extending all the way to the edges of the email.

To add a background wrapper image, enter the URL for that image in the third box.

Wrapper Background Repeat gives you a few options for how to use background images:

  • no-repeat – image only displays once in top left corner
  • repeat — Repeats in both directions (default)
  • repeat-x — Repeats only on the x-axis (horizontally across the element)
  • repeat-y — Repeats only on the y-axis (vertically down the element)
  • no-repeat — Does not repeat
  • space – same as repeat-x but evenly spaces along the x-axis
  • round – evenly spaces along x and stretches to fill entire y-axis

The wrapper background size enables you to determine how large the wrapper really is. If you want to have some space above, below, or around the edges of the content, set those dimensions here.

A/B Testing

To create an A/B test for an email, navigate to the main page for the page you want to test (before clicking Edit). Next to the options for “Edit”, “Send Example”, and “Close” in the top right, click the drop-down and select “Add A/B test.” We have a full article and video about A/B testing. It is also possible to create A/B tests for language variations.