Skip to content

Creating an email template

The Braze dashboard has an email template editor that allows you to create custom-tailored, eye-catching emails and save them for later use in campaigns. You can also upload your own HTML email template.

Creating your template

Step 1: Navigate to the email template editor

Go to Templates > Email Templates.

Step 2: Create or choose a template

Now, you can create a new template or edit an existing template (plain or mobile responsive) using the drag & drop editing experience or standard HTML experience. If you’d like to create a new template, you can choose from Braze’s predesigned templates or create a new layout.

New Template

Step 3: Customize your template

You can write your message within the rich-text editor or optionally flip over to our HTML editor or Drag & Drop Editor to customize your content. Once selected, you will be guided to the editor experience you chose. An HTML Editor or Drag-and-Drop Editor badge will appear, indicating that you are about to use this editing experience for template creation.

Drag and Drop Editor badge in the Email Body section

Braze will add a footer with an unsubscribe link at the bottom of your HTML emails by default. You can customize this footer as needed.

To enter a subject line, click Edit Sending Info.

Email Template Details panel in the HTML editor.

To enter the robust email editor, click Edit Email Body. If desired, use the dropdown in the Body tab to select the Classic, Block, HTML, or Plaintext email editor. The adjacent panel shows a real-time preview of the email being created.

Dropdown in the Body tab that displays options for the editor types.

Our editor supports HTML Autocomplete triggered by the Tab key. This feature should be used on naked HTML tags. For example, using Tab on a <head> tag will result in:

  <meta http-equiv="content-type" content="text/html; charset=utf-8" />

  <title>`substitute(Filename('', 'Page Title'), '^.', '\u&', '')`</title>


The drag & drop editing experience is divided into three sections: Sending Settings, Content, and Preview & Test.

Sending settings

The Sending Settings section allows you to configure your from and reply-to address as well as set the subject line or pre-header.


The Content section contains the editor. There are three key components within this section.

  • Content: This section includes a series of tiles that represent the different kinds of content you can use in your message. More will become available in the future. To use them, just drag one inside an existing row segment; it will auto-adjust to the column width. Every block has its own settings, such as granular control on padding. The right-side panel automatically switches to a property panel for the selected content element.

    For more information see Editor Block Properties

  • Rows: Rows are structural units that define the horizontal composition of a section of the message by using columns. Using more than one column allows you to put different content elements side by side. You can add all the structural elements you need to your message, regardless of the template you selected when you started.

  • Settings: General settings for the message. They are inherited by Rows and Content sections. For example, the font family set in the message settings will be used everywhere in your message, except where you use a custom setting.

This is very useful to build a coherent message very quickly.

Preview & Test

The Preview & Test section allows you to preview your email based on different users.

  • Random User: Braze will randomly select a user from the database and preview the email based on their attributes/event information. Note: This user may or may not be part of your segmentation criteria. Segmentation is selected afterward, so Braze is unaware of your target audience at this point.

  • Select User: You can select a specific user based on their email address or external ID. The email will preview based on that user’s attributes and event information

  • Custom User: You can customize a user. Braze will offer inputs for all available attributes and events. You can enter any information you would like to see in the preview email.

Inbox Vision is currently unavailable during this testing phase and will be made available in the future.

Braze will add a footer with an unsubscribe link at the bottom of your email by default. You can customize this footer as needed.

Step 4a: Check for email errors

Email errors are presented on the Compose tab of the message workflow. Errors prevent you from progressing forward. “Warnings” indicate reminders to help you follow best practices. Depending on your business, you might choose to ignore them.

Errors and warnings list from an example email.

Here’s a list of errors that are accounted for in our editor:

Step 4b: Preview and test your message

After you finish composing your template, you can test it before sending it out.

From the bottom of the overview screen, click Preview and Test. Here, you can preview how your email will appear in a customer’s inbox. With Preview as User selected, you can preview your email as a random user, select a specific user, or create a custom user. This allows you to test that your Connected Content and personalization calls are working as they should.

You can also switch between desktop, mobile, and plaintext views to get a sense of how your message will appear in different contexts.

When you’re ready for a final check, select Test Send and send a test message to yourself or a group of content testers to ensure that your email displays properly on a variety of devices and email clients.

Example email preview to be sent for testing.

If you see any issues with your template or want to make any changes, click Edit Email to return to the editor.

Step 5: Save your template

Be sure to save your template by clicking Save Template. You’re now ready to use this template in any campaign or Canvas component you choose. To access your template, select the editing experience you built it with, and then select it from the list of available templates.

Using your templates in API campaigns

To use your email for an API campaign, you need an email_template_id, which can be found at the bottom of any email template created in Braze.

Example Template API Identifier.

Managing email templates

You can duplicate and archive email templates! Learn more about creating and managing templates and creative content in Templates & Media.

Frequently asked questions

For answers to frequently asked questions about email templates, check out our Templates FAQ.

New Stuff!