Uploading an HTML email template
This article covers creating, managing, and troubleshooting HTML email templates in the Braze dashboard.
Email messages are great for delivering content to the user on their terms. They are also wonderful tools to re-engage users who may have even uninstalled your app. 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 create an Email Template using our editor.
Before you begin, you need to create your HTML email template. This must be a single ZIP file containing the following:
- A single HTML file—the body of your email
- A folder of images that are referenced in the HTML file
- Less than 50 image files
This ZIP file should be under 5 MB.
Uploading your template
Step 1: Navigate to the email template editor
Go to the Templates & Media page, under the Engagement section. This opens the Email Templates page.
Step 2: Open the uploader
Under the Template Type section, select HTML Editor. Then scroll down to the section Start from a Basic HTML Template and select From File.
Step 3: Upload your template
Click Upload From File and select your template from your computer. Refer to the Prerequisites section to ensure your template meets the upload requirements.
Solve upload email template errors
There are several email error messages you may receive when uploading an HTML template file. If you receive an error, refer to the table below for common issues and their recommended fixes:
|.zip over 5MB||Reduce your file size and try uploading again.|
|.zip corrupt||Inspect your file and try uploading again.|
|Missing HTML||Add HTML file to your ZIP file and try uploading again.|
|Multiple HTML||Remove one of the HTML files and try uploading again.|
|Images over 5MB||Reduce the number of images and try uploading again.|
|Extra Images||You may have additional images in your file that are not referenced in your HTML file. This will not cause a fail error, but the extra images will be discarded. If those images were supposed to be referenced in the HTML file, please check its contents, correct any errors, and try uploading again.|
|Missing Images||If there are images referenced in your HTML file, but those images are not included in the image folder of the ZIP file, you will receive a file error. Inspect your file and correct any errors (like misspellings), or add the missing images to your ZIP file and try uploading again.|
Step 4: Finish and save your template
Be sure to save your template by clicking Save Template in the bottom right corner of the editor. You’re now ready to use this template in any campaign or Canvas you choose.
If you make any edits to an existing template, those changes will not be reflected in campaigns that were 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 email and link templates FAQs page.