Skip to content

Uploading an HTML email template

The Braze dashboard allows you to upload your very own HTML email templates and save them for later use in campaigns. You can also create an email template using our editor.


First, you’ll need to create your HTML email template. This must be a ZIP file that contains 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
  • Be less than 5 MB

Uploading your template

Step 1: Navigate to the email template editor

Go to the Templates > Email Templates.

Step 2: Open the uploader

Under the Template Type section, select HTML Editor and scroll down to the section Start from a Basic HTML Template. 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.

Troubleshoot uploading 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 following table for common issues and their recommended fixes:

Error Fix
.zip over 5 MB Reduce your file size and try uploading again.
.zip corrupt Inspect your file and try uploading again.
Missing HTML Add the HTML file to your ZIP file and try uploading again.
Multiple HTML Remove one of the HTML files and try uploading again.
Images over 5 MB Reduce the number of images and try uploading again.
Extra Images There may be 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, then check the content, 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. You’re now ready to use this template in any campaign or Canvas you choose!

Using your templates in API campaigns

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

API Identifier section of an HTML email template.

Managing email templates

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

Frequently asked questions

For answers to frequently asked questions about email templates, check out our email and link templates FAQ page.

New Stuff!