> For the complete documentation index, see [llms.txt](https://docs.brigge.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.brigge.ai/documentation/email-templates.md).

# Email templates

## Introduction

Email templates are predefined message templates that can be applied when configuring pipeline [*Notification* nodes](/documentation/brigge-for-transformers/pipelines/pipeline-nodes/notification-node.md). Messages are created using [Markdown](#markdown-helper) (with integrated preview), and can include [payload, environment, and system variables](/documentation/brigge-for-transformers/pipelines/pipeline-variables.md).

## Working with email templates

<details>

<summary>Viewing existing email templates</summary>

To view existing email templates for your organisation, select *Settings* from the navigation menu, then select *Email templates* from the *Company management* section. All existing email templates are shown. For example:

<div data-with-frame="true"><figure><img src="https://2172380191-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8IqdqwZowcxtFpZfLa6k%2Fuploads%2FqZ4DozJqocFbJfOZkrBd%2Femail%20templates%20list.png?alt=media&amp;token=a2836d2f-cf4e-4b57-864a-81791bf65ba5" alt=""><figcaption></figcaption></figure></div>

From here, click any template to [view or update the content](#working-with-email-template-content). For example:

<div align="left" data-with-frame="true"><figure><img src="https://2172380191-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8IqdqwZowcxtFpZfLa6k%2Fuploads%2FYbs6qrX0FY7GqNnxdjEF%2Femail%20templates%20-%20select.png?alt=media&amp;token=e4ed87a9-0449-47b6-81c5-1bf27b85333f" alt="" width="375"><figcaption></figcaption></figure></div>

</details>

<details>

<summary>Creating an email template</summary>

To create a new email template, access the *Email templates* page and click the `create notification template` button. For example:

<div data-with-frame="true"><figure><img src="https://2172380191-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8IqdqwZowcxtFpZfLa6k%2Fuploads%2FSxoiUkXjl8lcYHCdYfxh%2Fcreate%20template%201.png?alt=media&amp;token=8ead3a3a-9e1a-4132-816e-e4abc37610eb" alt=""><figcaption></figcaption></figure></div>

From here, a new template page is displayed - [add content as needed](#working-with-email-template-content) and save changes.

</details>

<details>

<summary>Working with email template content</summary>

### Introduction

Having chosen to create a new email template, or having selected an existing template, the template page is displayed. For example:

<div align="left" data-with-frame="true"><figure><img src="https://2172380191-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8IqdqwZowcxtFpZfLa6k%2Fuploads%2FXJKAgqOf620Eb0npusoa%2Femail%20template.svg?alt=media&amp;token=e791a238-3e09-4507-8fea-f710778ad728" alt=""><figcaption></figcaption></figure></div>

Here, you can add content for a new template, or update an existing template:

{% stepper %}
{% step %}
**Update basic details**

In the *General* panel, enter a name and a `subject` for this template.&#x20;

* The `name` is displayed to users in Brigge wherever email templates can be selected (e.g. when configuring a [*Notification* node](/documentation/brigge-for-transformers/pipelines/pipeline-nodes/notification-node.md)).
* The `subject` is the email message subject line to be used when this template is applied.
  {% endstep %}

{% step %}
**Add or update content**

In the *Content* panel, add the required email message content (in [Markdown](#markdown-helper) format). [Switch between text and preview modes](#using-with-the-content-editor) to see how your content will be rendered in email messages.
{% endstep %}
{% endstepper %}

### Using the content editor

The content editor has two modes: `content` and `preview`.

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th><th></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td><strong>Content</strong></td><td>Use the <code>content</code> tab to enter <a href="#markdown-helper">Markdown text</a> for the email template.</td><td><img src="https://2172380191-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8IqdqwZowcxtFpZfLa6k%2Fuploads%2F2H6h8RGiJqYE9n7E5RL3%2Femail%20templates%20-%20content.png?alt=media&amp;token=8a873ae9-52cc-410f-8d06-7fbf081d9916" alt=""></td><td>Having entered required content, switch to <code>preview</code> mode to see how this will be rendered when applied in email notifications.</td><td></td></tr><tr><td><strong>Preview</strong></td><td>Use the <code>preview</code> tab to see how the current markdown content renders.</td><td><img src="https://2172380191-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8IqdqwZowcxtFpZfLa6k%2Fuploads%2FUho4aIKQJUTCgC5edHWT%2Femail%20templates%20-%20preview.png?alt=media&amp;token=4d5138ed-63a5-4096-9156-aa27dc30b9e2" alt=""></td><td>This is a live preview - there's no need to save the template before previewing.</td><td></td></tr></tbody></table>

### Markdown helper

```
# Headings

# H1 Heading
## H2 Heading
### H3 Heading
#### H4 Heading
##### H5 Heading
###### H6 Heading

# Hyperlinks

- [Visit Simplify VMS](https://www.simplifyvms.com)
- [Email Support](mailto:support@example.com)

# Images (render external images from links)

![Image alt text](full URL for the image)

For example:

![Simplify Logo](https://www.simplifyvms.com/images/simplify-logo.svg)

# Lists
## Bulleted list

- Item 1
  - Subitem A
  - Subitem B
- Item 2
- Item 3

## Numbered list

1. First
2. Second
3. Third

## Task List

- [x] Write the email
- [x] Add content examples
- [ ] Send it
- [ ] Wait for replies

# Text formatting

**Bold**
_Italic_
**_Bold & Italic_**
~~Strikethrough~~
> Blockquote 
`Code`

# Tables

| Col 1 Heading | Col 2 Heading | Col 3 Heading |
|---------------|---------------|---------------|
| Row 1 Col 1   | Row 1 Col 2   | Row 1 Col 3   | 
| Row 2 Col 1   | Row 2 Col 2   | Row 2 Col 3   |
| Row 3 Col 1   | Row 3 Col 2   | Row 3 Col 3   |
| Row 4 Col 1   | Row 4 Col 2   | Row 4 Col 3   |
| Row 5 Col 1   | Row 5 Col 2   | Row 5 Col 3   |

# Inject variable values
### Payload variables

Full payload
{{payload}}

Single payload field
{{payload.field.path}}

### System variables
{{system.variable_name}}
For example:
{{system.pipeline_run_id}}

### Environment variables
{{env.variable_name}}
For example:
{{env.env_name}}

```

</details>

<details>

<summary>Deleting an email template</summary>

{% hint style="warning" %}
You can't delete an email template if it's currently configured in pipeline [*Notification* nodes](/documentation/brigge-for-transformers/pipelines/pipeline-nodes/notification-node.md). If you attempt to do so, the operation fails with a list of any pipelines where the template is in use.
{% endhint %}

To delete an email template, [access the *Email templates* page and select the required template](#viewing-existing-email-templates), then scroll to the end of the template and click the `delete` button. For example:

<div data-with-frame="true"><figure><img src="https://2172380191-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8IqdqwZowcxtFpZfLa6k%2Fuploads%2FSxoiUkXjl8lcYHCdYfxh%2Fcreate%20template%201.png?alt=media&amp;token=8ead3a3a-9e1a-4132-816e-e4abc37610eb" alt=""><figcaption></figcaption></figure></div>

When prompted, confirm that you want to proceed - after this, the template is removed immediately.

</details>