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.

Templates require the Starter plan or above. Each plan also caps the number of templates you can store; once you hit the cap, creating another returns a 403.

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 the composer

In the dashboard composer, click Load Template and select the template by name. Its subject, HTML, and plain text are inserted into the composer fields. Edit them as needed, fill in any {{variables}}, then send.

Templates are loaded through the dashboard composer. To send programmatically, render your final HTML and plain text yourself and pass them in the html and text fields of the send API.

On this page