Creating an email template
This article covers how to create, customize, and manage email templates.
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
In the left navigation, click Templates & Media, under the Engagement section. This will open up the Email Template Gallery.
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.
Any existing custom HTML templates will need to be re-created using the Drag & Drop Editor.
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.
When composing your email template copy, do not switch back and forth between different editor types (HTML/Block/Classic) as that may shift the previously created HTML leading to rendering issues.
Braze will add a footer with an unsubscribe link at the bottom of your HTML emails by default. You can customize this footer in the Email Settings tab of the Manage Settings page. For more information, read our custom footer documentation.
To enter a subject line, click Edit Sending Info.
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.
Remember—when composing your email template copy, do not switch back and forth between different editor types (HTML/Block/Classic) as that may shift the previously created HTML leading to rendering issues.
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:
1 2 3 4 5 6 <head> <meta http-equiv="content-type" content="text/html; charset=utf-8" /> <title>`substitute(Filename('', 'Page Title'), '^.', '\u&', '')`</title> </head>
The drag & drop editing experience is divided into three sections: Sending Settings, Content, and Preview & Test.
The Sending Settings section allows you to configure your from and reply-to address as well as set the subject line or pre-header.
Advanced functionality will appear in the campaign or Canvas step composer. In advanced functionality, you can modify your inline CSS setting, set a BCC email address, and enter in a header or extra key-value pairs (if configured).
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.
To read more about the different components of the drag & drop editing experience, visit our Drag & Drop Editor documentation articles here.
Braze will add a footer with an unsubscribe link at the bottom of your email by default. You can [customize this footer][cf] in the Email Settings tab of the Manage Settings page.
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.
Here’s a list of errors that are accounted for in our editor:
- Incorrect Liquid syntax
- Email bodies larger than 400kb; bodies are highly recommended to be less than 102kb
- Templates without an unsubscribe link
- Emails with a blank Body or Subject
- Emails with no unsubscribe link
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.
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 step you choose.
If you make any edits to an existing template, those changes will not be reflected in campaigns created using previous versions of that template.
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.
Managing email templates
For answers to frequently asked questions about email templates, check out our Templates FAQs.