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

# Email Templates: Customise System Emails

> Design, translate, and manage all ten system email types with multiple profiles, a visual layout builder, AI translation, and live in-browser preview.

Site Store Pro sends automated emails at every key moment of the customer lifecycle — from order confirmation to password reset to support ticket updates. The Email Templates editor at **Admin → Email Templates** (`/admin/email-templates`) gives you full control over the content, branding, and language of every message your store sends without touching a single line of backend code.

## System Email Types

Your store ships with ten built-in email types. Each type is triggered automatically by a specific platform event and comes pre-populated with the variables relevant to that event.

| #  | Template Name                         | Trigger                                           | Key Variables                                                                                                                                                                    |
| -- | ------------------------------------- | ------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1  | **Order Confirmation**                | Customer completes checkout                       | `{{order_id}}`, `{{customer_name}}`, `{{order_total}}`, `{{order_subtotal}}`, `{{order_taxes}}`, `{{order_shipping}}`, `{{order_items_table}}`, `{{completion_redirect}}` button |
| 2  | **Order Shipment Confirmation**       | Admin marks order as shipped                      | `{{order_id}}`, `{{customer_name}}`, `{{tracking_number}}`, `{{order_items_table}}`                                                                                              |
| 3  | **Download Order Reminder**           | Admin clicks Send Download Reminder               | `{{order_id}}`, `{{customer_name}}`, `{{download_links}}`, `{{order_items_table}}`                                                                                               |
| 4  | **Customer Registration (Retail)**    | New retail customer registers                     | `{{customer_name}}`, `{{app_name}}`                                                                                                                                              |
| 5  | **Customer Registration (Wholesale)** | New wholesale customer registers                  | `{{customer_name}}`, `{{app_name}}`                                                                                                                                              |
| 6  | **Account Activation / Verification** | User requests verification or guest account setup | `{{customer_name}}`, `{{activation_url}}`, `{{app_name}}`                                                                                                                        |
| 7  | **Reset Password**                    | User submits a password reset request             | `{{customer_name}}`, `{{reset_url}}`, `{{app_name}}`                                                                                                                             |
| 8  | **Support Ticket Submitted**          | New support ticket is opened                      | `{{customer_name}}`, `{{ticket_title}}`, `{{ticket_status}}`, `{{ticket_url}}`                                                                                                   |
| 9  | **Support Ticket Reply Received**     | Staff posts a reply to a ticket                   | `{{customer_name}}`, `{{reply_author}}`, `{{reply_body}}`, `{{ticket_title}}`, `{{ticket_url}}`                                                                                  |
| 10 | **Support Ticket Status Updated**     | Ticket status changes (e.g. Resolved, Closed)     | `{{customer_name}}`, `{{ticket_title}}`, `{{previous_status}}`, `{{ticket_status}}`, `{{ticket_url}}`                                                                            |

### Variable Syntax

Insert dynamic data into any template field by wrapping the variable name in double curly braces. Site Store Pro replaces each placeholder with the live value at send time.

```text theme={null}
Dear {{customer_name}},

Thank you for your order #{{order_id}}.

Order Total:    {{order_total}}
Subtotal:       {{order_subtotal}}
Taxes:          {{order_taxes}}
Shipping:       {{order_shipping}}

{{order_items_table}}
```

<Note>
  For all order-related templates (Order Confirmation, Shipment Confirmation, Download Reminder), `{{order_items_table}}` is **automatically appended** to the body if you do not include it manually. You do not need to add it yourself, but you can position it explicitly if your layout requires it in a specific location.
</Note>

***

## Multiple Profiles & Active Selection

Every email type supports multiple named profiles. For example, you might maintain a **Default Order Confirmation** profile and a **Holiday Order Confirmation** profile for seasonal campaigns.

<Info>
  Only **one profile per email type** can be active at any time. The active profile is the version your store sends when the trigger fires.
</Info>

To switch the active profile:

<Steps>
  <Step title="Open the email type">
    Go to **Admin → Email Templates** and select the email type you want to update.
  </Step>

  <Step title="Choose a profile">
    Browse the list of profiles saved for that type.
  </Step>

  <Step title="Set it as active">
    Toggle the profile to **Active**. Site Store Pro automatically deactivates the previously active profile for that type.
  </Step>
</Steps>

<Warning>
  Activating a new profile immediately affects all emails triggered from that point forward. Preview the profile before activating it in a production environment.
</Warning>

***

## Visual Layout Builder

Each template profile is composed of four layout sections. Edit any section independently to control every part of the email's appearance and content.

<Accordion title="Header & Branding">
  Configure the sender identity and top-of-email visuals:

  | Field                | Purpose                                          |
  | -------------------- | ------------------------------------------------ |
  | **From Address**     | The reply-to email address recipients see        |
  | **From Name**        | The sender name displayed in the inbox           |
  | **BCC Address**      | Optional blind-copy address for internal logging |
  | **Header HTML**      | Raw HTML rendered at the very top of the email   |
  | **Banner Image URL** | URL of the header banner image                   |
  | **Show Banner**      | Toggle to show or hide the banner image          |
</Accordion>

<Accordion title="Salutation & Greeting">
  Control how the email opens after the header:

  | Field                  | Purpose                                           |
  | ---------------------- | ------------------------------------------------- |
  | **Include Salutation** | Toggle to include or omit the salutation line     |
  | **Salutation Text**    | Opening line, e.g. `Dear {{customer_name}},`      |
  | **Greeting Block**     | A styled HTML block rendered below the salutation |
</Accordion>

<Accordion title="Body HTML">
  The primary message content of your email. Write your main copy here using HTML. For order templates, `{{order_items_table}}` is appended automatically if you leave it out — see the note above.
</Accordion>

<Accordion title="Sign-Off & Footer">
  Control the closing content and footer branding:

  | Field                 | Purpose                                     |
  | --------------------- | ------------------------------------------- |
  | **Sign-Off**          | Closing line, e.g. *Warm regards,*          |
  | **Signature**         | Sender name or team name below the sign-off |
  | **Disclaimer**        | Legal or compliance text                    |
  | **Copyright**         | Copyright notice line                       |
  | **Footer Image URL**  | URL of the footer image                     |
  | **Show Footer Image** | Toggle to show or hide the footer image     |
  | **Footer HTML**       | Additional HTML rendered at the very bottom |
</Accordion>

***

## AI Translation

If your store serves multiple languages, the template editor displays a language tab for each active site language. To translate a template into another language:

<Steps>
  <Step title="Select a language tab">
    Open the template editor and click the tab for the target language (for example, **French** or **Spanish**).
  </Step>

  <Step title="Trigger AI translation">
    Click **AI Translate Email**. Site Store Pro automatically translates the subject line, greeting, body HTML, sign-off, and footer into the selected language.
  </Step>

  <Step title="Review and save">
    Check the translated output for accuracy, make any manual adjustments, then save the profile.
  </Step>
</Steps>

<Tip>
  Run AI translations on all language tabs before activating a new seasonal profile. This ensures every customer receives a fully localised email regardless of their language setting.
</Tip>

***

## Live Email Preview

Before activating any profile, verify its appearance using the built-in preview:

1. Open the profile in the template editor.
2. Click **Preview Template**.
3. Site Store Pro opens an in-browser modal populated with realistic mock data — including a sample order, items table, tracking number, and activation links — so you can see exactly how the finished email will render.

<Info>
  The preview modal uses mock data, not live order records. No email is sent when you click Preview Template.
</Info>
