Create Email Template

In this area you'll learn how to create an email message template.

To access this area, expand the menu item Messages and click in Templates as follows:

Menu 75d4462c46

In this page, expand the New Template menu and click in in Email Template:

New email template button 9e1e6da204

This will take you to a wizard divided in five different tabs, as shown below:

Tabs 68ebeef786

Some sections are optional and you will notice that they are marked as ready by default.


In the Setup tab, you will need to provide a name for your template. This will help you identify templates later on:

Name f2a4997a01


If you would like to automatically categorize users when they open your messages, you can use segmentation rules to do so. Click in the Segmentation tab:

Segmentation e71dd2d3cd

Learn more about how to setup segmentation rules in our guides located here.


To actually create the content your users will see when you send an email message, click in the Content tab. If you are using our inbox functionality, you may localize your content in multiple languages. For that toggle the switch Use localized content to start creating content in other languages:

Use localized content 032fe3bb8f

Automatically a new tab called Default will appear, which will allow you to create the content that we will use as a fallback when the recipient that receives the message does not have a language provided by the localized content you create.

Default tab 2104813e74

Make sure you create the default content before proceeding to add more languages, as other localized content must share the same structure you use in the default content. When you are ready to add more languages, go ahead and click in the following button:

Add language button f4ca6508eb

This will open a new window where you can select a language/region combination. Note that region is a property that is only available in SDK 2.0 or higher, so it's important your apps use this version if you would like to have use a language/region combination. If your apps do not support this version or you simply don't need to create content based on a language/region combination, you can leave the region option unselected.

Add locallized content modal ffd74a42e7

Adding languages will eventually add new tabs to the message composer, as shown below. Make sure you localize all fields accordingly in each tab:

New language tab f582872e1b

An email message should contain a Subject:

Subject d856130074

Then you should provide a Body. You can either compose it using our component based editor or use your own HTML:

Body 2729fbda09

To learn more about these options, read the guide here.

By default we will use the body to automatically generate a plain-text version of your email, but if you wish to create your own, toggle the option below:

Use custom plain text 214aae1210

Then just provide your text in the field below:

Plain text b832fff437

Finally you can also upload files as attachments or use existing ones (if you have the Storage add-on) to your messages, by using the section below:

Attachments 472dc0d843


Optionally, for each email message, you can also configure some optional settings. To do that click in the Options tab. If you wish to use a different sender than the one you configure in your email service, use the fields below to define that. You can specify a different Sender Name:

Sender name e70cc911a1

Or a different Sender Address:

Sender address ab1b1f55b4

These values will be used in the FROM field of your message.


Finally you can configure the throttle rate of a message by clicking in the Delivery tab:

If you wish to throttle the delivery of a message, you can toggle the option below:

Throttle 07afa61b2f

This will allow you to specify the rate of how many messages we should send per second (min. 10/sec):

Throttle rate b406804993

Once you are done composing your message, click in the Create Template button to actually save the template:

Create button fa01e9c235

Keep reading our guides to learn how to edit a template.