Taifa MailTaifa Mail Docs
Sending Emails

Email Templates

Create reusable email templates with the block editor or raw HTML in Taifa Mail.

Templates let you design reusable email layouts that you can load in the dashboard composer.

Creating a template

  1. Go to Templates.
  2. Click Create Template.
  3. Give the template a name (internal only, not shown to recipients).
  4. Build the template with the block editor, or paste raw HTML.

A template stores a name, an optional subject, an html_body, a text_body, and the block editor layout (blocks_json).

Block editor

The block editor lets you build emails visually. Drag blocks into the canvas and click any block to edit its properties. The editor saves its layout alongside the rendered HTML, so you can keep editing visually later.

Variables

Use {{variable_name}} placeholders anywhere in the template's HTML or plain text body. Taifa Mail scans the bodies on save and records every placeholder it finds in the template's variables list, so you can see at a glance which values a template expects.

Variable substitution happens when you load the template into the composer and fill in the content before sending.

Managing templates

The Templates page supports the full lifecycle:

  • Edit -- update the name, subject, or bodies. The variables list is recalculated on every save.
  • Duplicate -- creates a copy named <original name> (copy).
  • Delete -- removes the template permanently.

Duplicate a production template before making changes. This way you always have a working fallback.

Using templates in broadcasts

When creating a broadcast, pick a saved template from the template selector (or start from Broadcasts → New with a pre-built layout). Edit subject and HTML, fill in any {{variables}}, then send.

The Compose → One-off tab does not load templates inline. To send programmatically, render your final HTML and plain text yourself and pass them in the html and text fields of the send API, or reference a template by ID where your integration supports it.

On this page