# Creating and managing custom email notification templates

{% hint style="info" %}
Email notification templates can only be created and managed by an Administrator.
{% endhint %}

Tablion's email notifications work out of a series of templates, one for each valid combination (or 'message type') of an in-system action and a user role (e.g. 'New Comment on Data Request' and 'Approver').

If a custom template is not created for an existing message type, the relevant email notification will follow Tablion's default template.

### How to create and manage custom email notification templates

1. Select 'Admin tools' from your username dropdown.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FGhDwWcsnEwDzLmAyFqM9%2Fimage.png?alt=media&#x26;token=14c9c1b3-44a0-4edb-87be-94437befc2d6" alt=""><figcaption></figcaption></figure>

2. Select the 'Notifications' tab.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FRpznhobvosgzO93rRUz4%2Fimage.png?alt=media&#x26;token=8d23f40b-164b-42ef-9d6e-6b17cb36debb" alt=""><figcaption></figcaption></figure>

3. Navigate to the message type that matches the scenario you wish to create or manage a template for and select 'View all templates' from its row.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2Fso0wOATpBGGc0G8QWm2y%2Fimage.png?alt=media&#x26;token=b5916cfb-18da-4a30-afd3-3d729ca2e514" alt=""><figcaption></figcaption></figure>

4. **If you wish to create a new template**, select 'Create'. **If you wish to edit an existing template**, select 'Edit' from the row of the relevant template.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FcVUOopD3relXA86557pJ%2Fimage.png?alt=media&#x26;token=7075556a-b1ae-460b-82a8-fd1f2cbb38f4" alt=""><figcaption></figcaption></figure>

5. Populate the 'Name' field as desired. This will only affect the name of the email notification template in Tablion, and will not influence the actual email notification.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FbDiBVR8hAJNfu8z8Pa1g%2Fimage.png?alt=media&#x26;token=2fd9e9d3-e3fb-4510-a117-d45295095558" alt=""><figcaption></figcaption></figure>

6. Populate the 'Subject' field with the subject you would like the email notification to have.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2F6Uj37nKeWOD4Rf8RGmZh%2Fimage.png?alt=media&#x26;token=dbbc8bba-8fac-4a1e-9972-c7cd12625a67" alt=""><figcaption></figcaption></figure>

**Notes:**&#x20;

* The subject field is able to make use of **variables**, which are listed at the bottom of the 'Create Message Template' page (below).
  * Inserting a variable name in the {{ correct\_format }} (as in the screenshot above) will automatically insert the information the variable represents in the email notification when it is sent to users
  * Only the listed variables and those contained in the default notification templates will work for email notifications.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FhNaEJdj0GG9sftz5cF14%2Fimage.png?alt=media&#x26;token=fc5a66df-ca71-45e2-ba79-666bd375bcfa" alt=""><figcaption></figcaption></figure>

7. **If you wish to write the email's body normally**, delete the contents (if any) of the 'Body HTML' field, and populate the 'Body Plain' field as desired. **If you wish to write the email's body in HTML**, populate the 'Body HTML' field with the desired HTML.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FelEFHg0vGaOD6XJwoc5U%2Fimage.png?alt=media&#x26;token=9341711c-07e8-4776-967c-fa590dd3fbad" alt=""><figcaption></figcaption></figure>

**Note:** These fields are able to make use of **variables**, which are listed at the bottom of the 'Create/Edit Message Template' page. See the notes of step 6 for more information.

8. **If you wish to have downloadable PDFs attached to this email notification**, select the 'Send PDF Documents' checkbox. **If you do not wish to have downloadable PDFs attached to this email notification**, proceed to step 11.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FsdMKlVZ4aGZ4vv6UPZoZ%2Fimage.png?alt=media&#x26;token=f1f70f66-0436-4ad5-8817-cd470ed94d1e" alt=""><figcaption></figcaption></figure>

9. Select the checkboxes of the document types you would like to be attached/downloadable as PDFs.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FD7ueLFpos3noMLSOAoJ6%2Fimage.png?alt=media&#x26;token=ca851cc0-5218-4bc7-8c5b-d3ae78aba3c6" alt=""><figcaption></figcaption></figure>

10. Ensure the disclaimer variable has been used in the 'Body Plain' and 'Body HTML' fields, then populate the 'Enter disclaimer text here...' field with your desired disclaimer.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FWDt1HGSSIz80FyPikZOc%2Fimage.png?alt=media&#x26;token=b8b725c2-8295-4f90-9aa2-e3a8ff009bd2" alt=""><figcaption></figcaption></figure>

11. Select 'Save' once satisfied.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FZPC01BQnxnFaHCzo2WIr%2Fimage.png?alt=media&#x26;token=f1078a80-eff3-4cd3-8dbe-ef06bec53fae" alt=""><figcaption></figcaption></figure>

12. To activate a notification template, select 'Activate' from its row. Once activated, the template will be used for any emails generated by the relevant message type/trigger.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FnmjSZDH3kI8utHcQXGlu%2Fimage.png?alt=media&#x26;token=aba59fca-9798-4635-8829-39a0d18fc9fe" alt=""><figcaption></figcaption></figure>

**Note:** Only one notification template can be activated for each message type at a time.

13. **If you wish to test a notification template**, select 'Test' from its row. An email will be sent to your Administrator email following the relevant template.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2Fr6Ub0grTmEjPSL9Yh4FE%2Fimage.png?alt=media&#x26;token=5ebbcd7e-ef5a-49dd-a4d7-72e946b1f00a" alt=""><figcaption></figcaption></figure>

14. **If you wish to delete a notification template**, select 'Delete' from its row, then confirm the deletion.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FKoFDOibiU81IXMrOzUfP%2Fimage.png?alt=media&#x26;token=39a049f3-0566-49a3-a988-c81e2763d8e7" alt=""><figcaption></figcaption></figure>
