Skip to main content

Email Templates

Explore a collection of professionally designed email templates or add your own custom designs. This section allows you to view, manage, and modify all templates available for your broadcasts, giving you the flexibility to edit, delete, or customize templates to suit your campaign needs.

Commercial License Required

Email Templates and Template Gallery features are only available to Commercial License holders.

Overview​

Email templates provide ready-to-use designs for broadcasts. The system supports two sources of templates: the Mumara Template Gallery (pre-designed templates you can install) and custom uploads (your own designs packaged as ZIP files).

+------------------+      +------------------+      +------------------+
|  INSTALL FROM    | ---> |  MANAGE IN       | ---> |  USE IN          |
|  GALLERY / UPLOAD|      |  TEMPLATES PAGE  |      |  BROADCASTS      |
+------------------+      +------------------+      +------------------+
        |                         |                         |
        v                         v                         v
+------------------+      +------------------+      +------------------+
| Pre-designed or  |      | Enable/disable,  |      | Choose editor,   |
| custom ZIP       |      | show to users    |      | pick template    |
+------------------+      +------------------+      +------------------+

Why Use Email Templates​

Consistency​

  • Brand identity — Consistent look across all campaigns
  • Professional appearance — Well-designed, tested layouts
  • Recognition — Recipients recognize your emails

Efficiency​

  • Faster creation — Don't start from scratch
  • Reusability — Use templates multiple times
  • Easy customization — Edit with visual or code editors

Quality​

  • Pre-designed layouts — Professional designs ready to use
  • Responsive — Mobile-friendly templates
  • Categorized — Organized by purpose and industry

Broadcast Templates​

Navigate to Setup → Email Templates to view and manage all installed templates.

Page Features​

ButtonDescription
Upload TemplateUpload a custom template (ZIP file)
Templates GalleryBrowse and install pre-designed templates from Mumara's collection
Update TemplatesRe-sync all installed templates with the latest versions from the server
  • Show entries dropdown to control page size
  • Search box to find specific templates

Table Columns​

ColumnDescription
Template NameThumbnail preview, template name, and description
CategoryTemplate category (Business, Notification, Ecommerce, etc.)
StatusEnable/disable toggle — controls whether the template is active in the system
Enable for UsersToggle to make the template visible to non-admin users when creating broadcasts
Created onDate and time the template was installed
ActionsRow action menu

Row Actions​

Click the ... (three dots) menu on any row to access:

ActionDescription
Edit TemplateModify the template HTML code
DeleteRemove the template and all its files from the system

Template Status vs Enable for Users​

These two toggles control different aspects of template visibility:

ToggleWho it affectsPurpose
StatusEveryoneMaster switch — when disabled, the template is inactive for all users including the admin
Enable for UsersNon-admin users onlyWhen enabled, the template appears in the template gallery when non-admin users create broadcasts. Admin users always see all active templates regardless of this toggle.
Template Visibility

For a template to appear to non-admin users when creating broadcasts, both Status and Enable for Users must be enabled.

Browse and install pre-designed templates from Mumara's template collection.

  1. Navigate to Setup → Email Templates
  2. Click Templates Gallery button
FeatureDescription
Select CategoryFilter templates by category
Search TemplateSearch templates by name
Hide Installed TemplatesCheckbox to hide already installed templates
Back to TemplatesReturn to the Broadcast Templates list

Template Cards​

Each template displays:

  • Preview thumbnail — Visual preview of the template (click to see full-size)
  • Template name — Name of the template
  • Category badge — Color-coded category label
  • Installed badge — Shown if template is already installed

Template Categories​

CategoryDescription
BusinessGeneral business communications
NotificationAlerts and notifications
EcommerceOnline store and product emails
Discount TemplatesSales and promotional offers
NewsletterRegular update newsletters
Invoice TemplatesBilling and invoice emails
Magazine TemplatesMagazine-style layouts
HealthcareMedical and health-related
ElectronicsTech and gadget promotions
CongratulateCelebration and congratulations
Order ListOrder confirmation emails
NewspaperNews-style layouts
ChatConversational style emails
HoneypotEngagement-focused templates

Installing Templates​

  1. Browse the gallery or search for a template
  2. Click on a template card to preview it
  3. Click Install to add it to your Broadcast Templates
  4. The template appears in your templates list with "Installed" badge

Template Preview​

Click on any template card to open a full preview:

  • View the complete template design
  • Try view in Browser link to see in new tab
  • Click X or outside to close the preview

Uploading Custom Templates​

Upload your own email templates to the system. Templates must be packaged as a ZIP file with a specific folder structure.

Required ZIP Structure​

Your ZIP file must contain these files at the root level (not inside a subfolder):

my-template.zip
├── index.html          (Required) Main email body HTML
├── header.html         (Required) HTML head section (DOCTYPE, <head>, opening <body>)
├── footer.html         (Required) Closing HTML tags (closing </body>, </html>)
├── thumbnail.png       (Required) Preview image shown in the template gallery
├── template.json       (Required) Template metadata
├── images/             (Optional) Image assets used in the template
│   ├── logo.png
│   ├── banner.jpg
│   └── ...
├── css/                (Optional) Stylesheet files
│   └── style.css
└── blocks/             (Optional) Reusable content blocks
    └── Content 1/
        ├── block.html
        └── img/
File Structure

All required files must be at the ZIP root. If template.json is inside a subfolder, the upload will be rejected.

Required Files Explained​

template.json​

Contains the template metadata. Here is an example:

{
  "name": "Business Promotion",
  "short_description": "A clean business email template",
  "description": "Professional business promotion template with a hero banner, content sections, and call-to-action buttons.",
  "category": "Business",
  "keywords": "business, promotion, professional",
  "tags": ["business", "promotion"],
  "version": "v1",
  "status": 1
}
FieldRequiredDescription
nameYesTemplate name displayed in the gallery
categoryNoCategory for filtering (defaults to "Other" if missing)
short_descriptionNoBrief summary shown in template cards
descriptionNoFull description for search and filtering
keywordsNoComma-separated keywords for search
tagsNoArray of tags for search and filtering
versionNoTemplate version identifier
statusNo1 = enabled, 0 = disabled (defaults to 1)
Auto-Generated Fields

When a template is uploaded, the system automatically sets id, user_id, date, thumbnail, and show_to_user fields. You do not need to include these in your template.json.

index.html​

The main email body content. This is the core of your template — the visible content between the header and footer.

  • Should contain the email layout (tables, content blocks, images)
  • Use relative paths for images: src="images/logo.png" — the system rewrites these to absolute URLs automatically
  • Use relative paths for CSS: href="css/style.css" — also rewritten automatically

header.html​

The HTML opening structure. Typically contains:

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

footer.html​

The HTML closing structure:

</body>
</html>

thumbnail.png​

A preview image of your template. This is displayed in the template gallery when users browse templates.

  • Format: PNG
  • Recommended size: Around 300×400 pixels
  • Content: A screenshot or mockup of the full template design

Upload Process​

  1. Navigate to Setup → Email Templates
  2. Click Upload Template
  3. Select your ZIP file
  4. The system validates the ZIP structure and extracts the template
  5. The template appears in your templates list

What Happens During Upload​

  1. The ZIP is validated — all 5 required files must be present
  2. The template is extracted to the storage directory
  3. template.json is updated with system fields (id, user_id, date, etc.)
  4. If the Builder addon is active and licensed, header.html, index.html, and footer.html are merged into a single index.html for Drag & Drop Builder compatibility
  5. Image and CSS paths in the HTML are rewritten to absolute URLs
  6. The template becomes available in the Broadcast Templates list

Editing Templates​

Edit Template HTML​

  1. Click Edit Template from the row actions
  2. The HTML editor modal opens with syntax highlighting
  3. Modify the HTML code as needed
  4. Click Update to save changes

The editor provides:

  • Syntax highlighting for HTML/CSS
  • Line numbers for reference
  • Full HTML access for customization
Template Changes

Changes to template HTML affect all future broadcasts using this template. Existing broadcasts that already used this template are not affected — each broadcast gets its own copy of the template at creation time.

Update Templates​

Re-sync templates with the latest versions from Mumara's server.

How to Update​

  1. Click Update Templates button
  2. A notification appears: "The broadcast templates are being resynced in the background"
  3. New versions of installed templates are downloaded and updated
  4. Existing template settings (status, enable for users) are preserved
Background Process

Template updates run in the background. You can continue working while templates are being synced.

Using Templates in Broadcasts​

When creating a new broadcast, the process starts with choosing your editor, followed by selecting a template.

Broadcast Creation Flow​

"+ Add New" Broadcast
        |
        v
+---------------------+
| Choose Your Editor  |
|---------------------|
| [HTML Editor]       |  --> Template gallery slides in below
| [D&D Builder]       |  --> Template gallery slides in below
| [AI Builder]        |  --> Redirects to AI Builder (no templates)
+---------------------+
        |
        v
+---------------------+
| Choose a Template   |
|---------------------|
| [Start Blank]       |  --> Creates empty broadcast
| [Template cards]    |  --> Uses selected template
| Search & filter     |
+---------------------+
        |
        v
+---------------------+
| Editor Opens        |
| with template       |
| content loaded      |
+---------------------+

Step 1: Choose Your Editor​

When you click Add New from the Broadcasts page, you see three editor options:

EditorDescription
HTML EditorCode-based editor with visual preview — edit HTML content directly or use the WYSIWYG interface
Drag & Drop BuilderVisual builder with drag-and-drop widgets, modules, and design tools (requires Builder addon)
AI BuilderDescribe what you need and AI generates a professionally written broadcast (requires AI to be enabled)

Clicking HTML Editor or Drag & Drop Builder reveals the template gallery below. Clicking AI Builder redirects you directly to the AI chat interface (since AI generates content from scratch, templates don't apply).

Single Editor Available

If only the HTML Editor is available (no Builder addon, no AI), the system skips the editor selection step and takes you directly to the editor.

Step 2: Choose a Template​

After selecting your editor, the template gallery appears with:

  • Start Blank card — always available, creates an empty broadcast
  • Template cards — all enabled templates with thumbnails
  • Category filter — dropdown to filter by category
  • Search — find templates by name, keywords, tags, or description
  • Preview — click the eye icon on any template to see a full-size preview

Step 3: Use a Template​

  • Hover over a template card and click Use This to select it
  • Or click Start Blank to start from scratch
  • The system creates a draft broadcast with the template content loaded and redirects you to the chosen editor

Templates Marked "Assigned"​

When browsing templates, non-admin users may see an Assigned badge on some templates. These are templates created by the admin and made available to users via the "Enable for Users" toggle. Users can use these templates but cannot edit or delete them.

Template Design Tips​

Layout​

  • Single column — Best for mobile responsiveness
  • Maximum width — 600px for compatibility across email clients
  • Padding — 20px minimum around content
  • White space — Don't overcrowd the design

Typography​

  • Font size — 14-16px for body text
  • Line height — 1.5 for readability
  • Safe fonts — Arial, Georgia, Verdana, Helvetica
  • Contrast — Dark text on light background

Images​

  • Relative paths — Use src="images/logo.png" in your template; the system rewrites them to absolute URLs on upload
  • Optimize size — Compress for fast loading
  • Alt text — Always include for accessibility
  • Balance — Don't rely solely on images (many email clients block them by default)

Mobile Responsive​

  • Fluid tables — Use percentage widths
  • Stack columns — Single column on mobile
  • Large buttons — Minimum 44px touch target
  • Readable text — Don't require zooming

Best Practices​

Template Management​

  • Organize by category — Use meaningful categories in template.json so users can filter easily
  • Disable unused — Turn off templates not in use via the Status toggle
  • Regular updates — Sync with latest templates periodically using "Update Templates"
  • Test before enabling — Preview templates and test them with a draft broadcast before enabling for users

User Access​

  • Enable selectively — Only enable templates users need via the "Enable for Users" toggle
  • Maintain quality — Only enable professional, tested templates for users
  • Review periodically — Audit enabled templates regularly

Custom Template Creation​

  • Follow the ZIP structure — Ensure all 5 required files are present at the root
  • Use a clear thumbnail — A good thumbnail.png helps users identify templates quickly
  • Fill metadata — Add keywords, tags, and descriptions in template.json so templates are easily searchable
  • Preserve structure — Maintain responsive table-based layout when editing templates
  • Test thoroughly — Check in multiple email clients after uploading
  • Keep the original ZIP — Save your source ZIP in case you need to re-upload

Troubleshooting​

Template Upload Fails​

Possible causes:

  • Missing required file (index.html, header.html, footer.html, thumbnail.png, or template.json)
  • template.json is inside a subfolder instead of at the ZIP root
  • File is not a valid ZIP archive
  • Not a .zip file extension

Solutions:

  • Verify all 5 required files exist at the ZIP root level
  • Re-create the ZIP ensuring template.json is not nested in a folder
  • Use a proper ZIP compression tool

Template Not Appearing for Users​

Possible causes:

  • Status is disabled
  • Enable for Users is disabled
  • Template not installed

Solutions:

  • Enable the Status toggle
  • Enable the "Enable for Users" toggle
  • Install the template from the Gallery or upload it

Template Preview Not Loading​

Possible causes:

  • Browser blocking popup
  • Network issues
  • Template HTML errors

Solutions:

  • Allow popups for the site
  • Check network connection
  • Validate template HTML

Update Templates Not Working​

Possible causes:

  • Network connectivity issues
  • Server temporarily unavailable
  • License validation issue

Solutions:

  • Check internet connection
  • Try again later
  • Verify license status in Settings → License Information

Template Rendering Incorrectly​

Possible causes:

  • Invalid HTML structure
  • CSS conflicts
  • Missing images (broken paths)

Solutions:

  • Validate HTML code
  • Use inline CSS for maximum email client compatibility
  • Check that image URLs are accessible — the system rewrites relative paths on upload, but externally hosted images need valid absolute URLs

Next Steps​

Last updated on