Tablion Data Portal help documentation
  • Tablion Data Portal
  • User Accounts
    • How to sign up in Tablion
    • Editing profile details
    • User Dashboards
    • How to set up Multi Factor Authentication?
  • Administrator Tools
    • Users
      • How to Add Additional User Profile Fields to Request Data
      • Blocking user accounts
      • Changing user roles
    • Data Teams
      • Creating and editing data teams
      • Deactivating and reactivating data teams
      • Assigning data teams to data requests and allocating tasks
    • Datasets
      • How to Create a New Dataset in Tablion
      • How to Extract Datasets from the Aristotle Metadata Registry into Tablion
      • How to Manage Datasets in Tablion
        • Application Requirements
          • Data Request Approval Notifications
    • Document Types
      • How to create a document type?
      • How to attach document type to a dataset?
    • How to digitise an undertaking or legal agreement around data use
    • Creating and editing custom pages
    • Creating and editing custom content
    • Versions
      • Dataset Versions
      • Data Passport type Versions
      • User Versions
      • Dataset Paradata Versions
    • Creating and managing custom email notification templates
  • Data Requests
    • Creating and submitting a data request
      • Data Request Checklist
    • Searching for data requests
    • Approving a data request and onboarding its team
  • Data Passports
    • Creating and managing data passports
    • Applying for a data passport
    • Approving or denying a data passport application
Powered by GitBook
On this page
  1. Administrator Tools

Creating and managing custom email notification templates

PreviousDataset Paradata VersionsNextData Requests

Last updated 1 month ago

Email notification templates can only be created and managed by an Administrator.

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.

  1. Select the 'Notifications' tab.

  1. 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.

  1. 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.

  1. 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.

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

Notes:

  • 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.

  1. 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.

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.

  1. Select 'Save' once satisfied.

  1. 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.

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

  1. 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.

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