> ## Documentation Index
> Fetch the complete documentation index at: https://help.statisfy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Email Builder

> Create and manage email templates for campaigns using the drag-and-drop editor.

The Email Builder provides a visual drag-and-drop editor for creating email templates. Build professional emails for campaigns without writing code.

### Accessing Email Builder

Navigate to **Admin > Studio > Email Builder**. Admin permissions are required.

### Creating a Template

1. Click **Create Template**
2. Enter a template name
3. The drag-and-drop editor opens

### Template Type

Each template has a **Template Type**: **Promotion**, **Newsletter**, **Updates**, or **Custom**. The type determines whether an unsubscribe link is required before the template can be published.

<Note>
  **Updates** is for transactional and product-update emails — messages recipients expect as part of using your product, such as feature announcements or account notices. Updates templates can be published without an unsubscribe link. Templates of any other type must include one, or publishing fails with the error "Unsubscribe is missing in the template."
</Note>

### Using the Editor

The email editor uses a drag-and-drop interface (powered by Unlayer) with these key areas:

**Content Panel (Left):**
Drag elements from the panel onto your email canvas:

| Element     | Description                                     |
| ----------- | ----------------------------------------------- |
| **Text**    | Rich text block with formatting options         |
| **Image**   | Insert images with alt text and links           |
| **Button**  | Call-to-action buttons with customizable styles |
| **Divider** | Visual separator between sections               |
| **Columns** | Multi-column layout (2, 3, or 4 columns)        |
| **HTML**    | Raw HTML block for advanced customization       |
| **Social**  | Social media icon links                         |

**Canvas (Center):**
Your email preview. Click on any element to edit it. Drag elements to rearrange.

**Properties Panel (Right):**
When an element is selected, configure its properties — colors, padding, alignment, links, etc.

### Custom Tools

The editor includes Statisfy-specific tools:

<CardGroup cols={2}>
  <Card title="Survey Link" icon="clipboard-list">
    Insert a link to a published survey. The link is automatically personalized for each recipient.
  </Card>

  <Card title="Unsubscribe Link" icon="link-slash">
    Insert an unsubscribe link to comply with email regulations. Required for all template types except **Updates**.
  </Card>
</CardGroup>

<Warning>
  Campaign emails must include an unsubscribe link — templates without one cannot be published. The exception is the **Updates** template type (transactional and product-update emails), which may omit it. See [Campaign Unsubscribe](/campaigns/campaign_unsubscribe) for details on how unsubscribe works.
</Warning>

### Personalization

Insert dynamic fields into your email content using merge tags. Merge tags use entity prefixes to reference specific fields:

* `{{contact.first_name}}` — Recipient's first name
* `{{account.name}}` — Recipient's associated account name
* `{{user.email}}` — The sender's email address

Click the **Merge Tags** button in the text editor to browse and insert available fields. Tags are grouped by entity type (Account, Contact, User) and include all mapped fields.

### HTML Export

For advanced users, you can export your template as raw HTML:

1. Click the **More Options** menu
2. Select **Export HTML**
3. The HTML file downloads to your computer

You can also import HTML to start from an existing template.

### Preview and Test

1. Click **Preview** to see how the email renders on desktop and mobile
2. Toggle between **Desktop** and **Mobile** views
3. Click **Send Test Email** to send a test to yourself

<Tip>
  Always preview on both desktop and mobile before using a template in a campaign. Email rendering varies significantly across devices and email clients.
</Tip>

### Saving Templates

* **Save** — Save the template for later use
* Templates are available for selection when creating a campaign

### Managing Templates

From the Email Builder list:

| Action        | Description                           |
| ------------- | ------------------------------------- |
| **Edit**      | Open the template in the editor       |
| **Duplicate** | Copy a template as a starting point   |
| **Delete**    | Permanently remove the template       |
| **Preview**   | Quick view without opening the editor |