# Custom email templates

Statuspal allows you to fully customize the look of your subscriber emails (confirmation and status notifications), you'll find this settings under `Sidebar > Subscriptions > Settings`:

![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/5b7c6e932c7d3a03f89df563/images/5fd1d9d7db2fa3720c7d7e44/file-TYMywW53so.png)

### **The Layout Template**

First you'll need to configure a layout template, basically the parent template that will render the content template under `{{ content }}`, this way you can reuse some HTML and styles across the content templates, see an example [here](/platform/subscriptions-and-notifications/custom-email-templates/template-examples.md#layout-template-example).

### **The Content Templates**

Then you can configure the template for both types of emails, you can see examples of both containing the supported variables [here](/platform/subscriptions-and-notifications/custom-email-templates/template-examples.md#content-template-examples).

### **Premailer**

We use Premailer on the email templates before sending the emails, so CSS styles are converted to inline style attributes and [other niceties](http://premailer.dialect.ca/).

### **Test and Enable**

Once you've configured the templates (and clicked on Submit) you can send a test email before you enable the templates, if they look good you can enable them so they are used on all future emails.

### **Available email template variables**

When customizing the email templates HTML the following variables are available:

| Translations            |                                                     |
| ----------------------- | --------------------------------------------------- |
| `t_update`              | "Update"                                            |
| `t_affected_services`   | "Affected services"                                 |
| `t_find_out_more`       | "Find out more at our"                              |
| `t_status_page`         | "Status Page"                                       |
| `t_manage_subscription` | "Manage subscription"                               |
| `t_open_report`         | "Open incident report" or "Open maintenance report" |

<table data-full-width="false"><thead><tr><th>Incident variables</th><th></th></tr></thead><tbody><tr><td><code>status_page.name</code></td><td>The status page name</td></tr><tr><td><code>incident.type_name</code></td><td>The incident type name (Minor, Major)</td></tr><tr><td><code>incident.title</code></td><td>The title of the incident</td></tr><tr><td><code>incident.type_color_class</code></td><td>The CSS class that we'll apply to set the color of the notification<br>  • <code>ok</code> <em>when it's a maintenance</em><br>  • <code>bad</code> <em>when it's a major incident</em><br>  • <code>warning</code> <em>when it's a minor incident</em><br>  • <code>good</code> <em>when it's a resolved incident</em><br>  • <code>info</code> <em>when it's an information notice</em></td></tr><tr><td><code>incident.url</code></td><td>The URL to the incident</td></tr><tr><td><code>activity.activity_type_name</code></td><td>The incident update type name (Issue, Investigating, Monitoring, Resolved, etc)</td></tr><tr><td><code>activity.description</code></td><td>The incident update description</td></tr><tr><td><code>maintenance_information</code></td><td>If a maintenance, the start and end of the maintenance will be here</td></tr><tr><td><code>services</code></td><td>The list of services, rendered as HTML (<code>&#x3C;div class="services">...&#x3C;/div></code>)</td></tr><tr><td><code>subscription.manage_url</code></td><td>The URL where the subscribers can manage their subscription</td></tr></tbody></table>

### **Notification email subject variables**

You can customize the incident notification subject via a [custom translation](/platform/multi-language.md) editing the `subscriber_email.subject` field, you can reference variables through the format `{{ variable_name }}`.

The following variables are available:

| `activity_type_name` | The incident update type name (Issue, Investigating, Monitoring, Resolved, etc) |
| -------------------- | ------------------------------------------------------------------------------- |
| `status_page_name`   | The status page name                                                            |
| `incident_type_name` | The incident type name (Minor, Major)                                           |
| `incident_id`        | The incident ID                                                                 |
| `incident_title`     | The title of the incident                                                       |

### Customizing your Templates to Include your Company Logo

Including your company logo is easy with the fields described above, after adding your company logo this is how the emails will look:

<figure><img src="/files/7ZufSBnN1rT1HBs4E6uZ" alt=""><figcaption></figcaption></figure>

Simply use the HTML content found in [Template exampes](/platform/subscriptions-and-notifications/custom-email-templates/template-examples.md) and replace the logo image (`<img ... class="logo"/>`) with your logo image.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.statuspal.io/platform/subscriptions-and-notifications/custom-email-templates.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.