Skip to main content

Email Templates

Email templates are ready-made designs you start new broadcasts from, so every email doesn't begin with a blank page and your campaigns keep a consistent look. You manage them under Setup → Email Templates.

+----------------------+      +----------------------+      +----------------------+
| ADD | ---> | MANAGE | ---> | USE |
| Templates Gallery | | Setup → | | Campaigns → |
| or Upload Template | | Email Templates | | Broadcasts → Add New|
+----------------------+ +----------------------+ +----------------------+
Install a design Switch on or off Pick an editor,
or upload a ZIP Edit the HTML then Use This

The Broadcast Templates page​

Go to Setup → Email Templates. The page is titled Broadcast Templates.

ColumnWhat it shows
Template NameThe thumbnail, name and short description. Click the thumbnail or the eye icon to see it full size.
CategoryThe template's category, such as Business or Newsletter.
StatusA switch that decides whether the template is offered when you create a broadcast.
Created onWhen the template was added.
ActionsEdit Template and Delete.

Templates marked Assigned by admin are provided by Mumara to every account. You can start broadcasts from them, but their Status and Actions show ---- because you can't change or delete them.

Switch a template on or off​

A template is only offered when you create a broadcast while its Status is on. Switch off the templates you don't use to keep the choice short. You'll see "Template has been activated successfully." or "Template has been deactivated successfully."

  1. On Setup → Email Templates, click Templates Gallery.
  2. Browse the designs. To narrow them down:
    • Select Category shows one category, such as Business, Newsletter or Ecommerce.
    • Search Template finds designs by name, description, keywords or tags.
    • Hide Installed Templates hides the designs you already have.
  3. Click a design's eye icon to see it full size.
  4. Click Install. After a few seconds the button changes to Already Installed, and the template appears on Broadcast Templates.

Scroll down to load more designs. Back to Templates returns you to your templates.

Upload your own template​

You can upload any design packaged as a ZIP file in the structure below, for example one exported from your design tool or made by your designer.

What the ZIP must contain​

These five files must be at the top level of the ZIP, not inside a folder:

my-template.zip
├── index.html (required) the email body
├── header.html (required) the opening HTML: DOCTYPE, <head> with styles, opening <body>
├── footer.html (required) the closing tags: </body></html>
├── thumbnail.png (required) the preview picture shown in lists
├── template.json (required) the template's details
├── images/ (optional) images used by the template
└── css/ (optional) stylesheets
Zip the files, not the folder

If you compress the folder that holds the files, everything ends up inside a subfolder and the upload is refused with "Your .zip file doesn't meet template directory structure requirements." Select the files themselves and compress them.

index.html holds the visible content of the email: its tables, text, images and buttons. Refer to images with relative paths, such as src="images/logo.png"; they're converted to full web addresses when the template is used. If index.html is already a complete page, starting with <!DOCTYPE html>, it's used as it is. Otherwise it's wrapped in header.html and footer.html.

header.html opens the page, for example:

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Newsletter</title>
<style>
/* your CSS */
</style>
</head>
<body>

footer.html closes it:

</body>
</html>

thumbnail.png is the preview picture shown on Broadcast Templates and when you create a broadcast. A portrait screenshot of the whole design, around 300 × 400 pixels, works well.

template.json describes the template:

{
"name": "Monthly Newsletter",
"short_description": "Two-column newsletter with a hero image",
"description": "A newsletter layout with a hero banner, two article columns and a call-to-action button.",
"category": "Newsletter",
"keywords": "newsletter, monthly, articles",
"tags": ["newsletter", "articles"],
"version": "v1",
"status": 1
}
FieldRequiredWhat it's for
nameYesThe name shown in the lists.
categoryNoThe category used for filtering. Templates without one are filed under Other.
short_descriptionNoThe line shown under the name.
descriptionNoA longer description, used when searching.
keywordsNoComma-separated words used when searching.
tagsNoA list of tags used when searching.
versionNoYour own version label.
statusNo1 to switch the template on after upload (the default), 0 to upload it switched off.

Mumara ONE adds the template's ID, owner and date for you.

Upload it​

  1. On Setup → Email Templates, click Upload Template.
  2. In Upload a Template, click Select File and choose the ZIP.
  3. Click Upload.

Mumara ONE checks the file before adding it. When it's done you'll see "The template has been successfully uploaded." and the template appears in the list.

If something's wrong, the dialog says what:

MessageWhat to fix
Only zip file is allowed.Upload a .zip file.
index.html file not found, header.html file not found, footer.html file not found, thumbnail.png file not found or template.json file not foundAdd the missing file to the ZIP.
Your .zip file doesn't meet template directory structure requirements.The files are inside a folder. Zip the files themselves, as described above.

Edit a template's HTML​

  1. Open the template's Actions menu and choose Edit Template.
  2. The template's HTML (its index.html) opens in a code editor with line numbers.
  3. Make your changes and click Update.
Existing broadcasts keep their copy

Each broadcast gets its own copy of the template when it's created. Editing a template only changes broadcasts you create from it afterwards; broadcasts you've already made are unaffected.

Delete a template​

Open the template's Actions menu, choose Delete and confirm. The template and its files are removed for good. Broadcasts you've already created from it keep their own copy.

Start a broadcast from a template​

  1. Go to Campaigns → Broadcasts and click Add New.
  2. Choose the editor: HTML Editor or Drag & Drop Builder. The templates appear under Choose a Template. (The AI Email Builder writes the email from your description, so it doesn't use templates.)
  3. Filter with Select Category or Search Template, and click a template's eye icon to preview it. Templates marked Assigned are the ones Mumara provides.
  4. Click Use This on a template, or Blank Template to start from scratch.

The broadcast opens in the editor with the template's content. See Broadcasts and Drag & Drop Email Builder.

Designing your own templates​

  • Keep it to one column, or columns that stack on phones. Most email is read on mobile.
  • Keep the width to about 600 pixels so the design fits every email client.
  • Use web-safe fonts such as Arial, Georgia, Verdana or Helvetica, at 14 to 16 pixels for body text.
  • Put styles inline as well as in header.html, because some email clients ignore <style> blocks.
  • Don't rely on images alone. Many email clients block images until the reader allows them; give every image alt text.
  • Make buttons big enough to tap, at least 44 pixels high.
  • Fill in template.json fully so the template is easy to find by category and search.
  • Keep the original ZIP, in case you need to upload it again.

Troubleshooting​

ProblemWhat to check
The upload is refusedSee the messages in Upload it. Most often a file is missing or the files are inside a folder.
A template isn't offered when I create a broadcastIts Status is off. Switch it on.
Templates Gallery doesn't load or a design won't installTry again in a few minutes. If it keeps failing, contact Mumara support.
Images are missing in the emailCheck the image paths in index.html point to files in the ZIP's images folder, or to full web addresses.
The design looks wrong in some email clientsMove important styles inline and test the broadcast on desktop and mobile before you send.

Next steps​