Email Workflow
Tyk Enterprise Developer Portal
If you are interested in getting access, contact us at [email protected]
The Tyk Enterprise Developer Portal enables admin users to customize emails that are sent to the API consumers and admin users upon certain events that happen on the portal. As an admin user, you can fully customize emails that are sent from the portal.
This section provides a guide to email customization.
List of email notifications
The Tyk Enterprise Developer Portal sends notifications for the following events:
Event | Text template | HTML template | Default template |
---|---|---|---|
Password reset | reset.text.tmpl | reset.html.tmpl | reset.tmpl |
New access request | submitted.text.tmpl | submitted.html.tmpl | submitted.tmpl |
Access request approved | approve.text.tmpl | approve.html.tmpl | approve.tmpl |
Access request rejected | reject.text.tmpl | reject.html.tmpl | reject.tmpl |
Pending user registration request | newuser.text.tmpl | newuser.html.tmpl | newuser.tmpl |
Invitation to a user to register in the portal | invite.text.tmpl | invite.html.tmpl | invite.tmpl |
User account is activated | activate.text.tmpl | activate.html.tmpl | activate.tmpl |
User account is deactivated | deactivate.text.tmpl | deactivate.html.tmpl | deactivate.tmpl |
Modification of email templates
To render an email, the portal uses the email templates that are contained inside /mailers
directory of your active theme.
To modify the templates, as an admin user, you need to download and unzip the theme that you want to modify:
- Navigate to the Themes menu.
- Download the theme that you want to modify:
- Unzip the theme and navigate to the mailers folder:
- Inside the mailer folder there are two types of assets: layouts and templates:
- The templates define the content for a specific email notification.
- The layouts are responsible for displaying the content of the templates.
Layouts
These are three layouts:
- HTML layout: emails.html.tmpl.
- Text layout: emails.text.tmpl.
- The default layout: emails.tmpl.
The HTML and text layout are used to render HTML and plain text content respectively. If the portal fails to find both the HTML and the text templates, it will use the default one.
To display the content of a template, the layout use special keyword yield
: {{ yield }}
.
Templates
Each event has three email templates:
- HTML template is used to display the HTML content in email client.
- Text template is used to display the plain text content in email client.
- Default template is used when neither HTML nor text templates is presented.
As an admin user, you can modify any of these templates.
Applying changes to themes
You need to upload the theme to the portal and activate it to make the changes to the email templates effectively:
- Navigate to the theme folder. Select all the files and compress them:
- As an admin user, navigate to Theme menu. Select the theme you want to update and upload the theme archive:
- Once the theme archive is selected, click on the Save changes button to upload the archive:
- Finally, you need to activate the theme if it’s not already active: