How to create custom email templates?

Owned by Nataliya Timoshina
Last updated: Feb 08, 2022
4 min read

Jira Administrator can create own email templates for their specific business purposes. Mail Me users will be able to use them when sending emails.

To create custom email templates, please follow the next steps:

 

 

Step 1. Go to the Navigation bar and select Apps - Mail Me.

 

Step 2. To manage custom templates click the Templates tab on the left side menu.

 

Step 3. Click Add new template button.

You will be redirected to the “Add template” page.

 

Step 4. Create custom email templates by filling the fields.

 

 

You can use our prompts and descriptions:

  1. Name - a required field, name of the template - it must be unique.

  2. Example template - you can choose Jira’s default template as a basis and change it.

  3. Context parameters - you can use it as a cheat sheet with the issue parameters

  4. HTML Body Template - a required field, template content for HTML format email.

  5. Text Body Template - a required field, template content for Text format email.

  6. Save - saves the template and redirects you to the page with a list of templates.

  7. Cancel - allows you to return to the previous page with a list of templates without saving.

 

Context parameters

In templates, we use double braces {{ }} as place-holders for data (also known as “Mustache” syntax). The mustache tag will be replaced with the value of the corresponding issue property in the email.

Project

{{projectKey}}

Project key of current issue

{{projectName}}

Project name of current issue

{{projectLink}}

Link to project of current issue

{{projectTypeKey}}

Project type key of current issue

{{projectAvatar}}

Link to project avatar (32x32)

Issue

{{issueKey}}

Issue key

{{issueLink}}

Link to issue

{{issueSummary}}

Issue summary

{{issueOriginalDescriptionHtml}}

Issue description (html format)

{{issueOriginalDescriptionMarkup}}

Issue description (markup format)

{{issueType}}

Issue type

{{issueTypeAvatar}}

Link to issue type avatar

{{issuePriority}}

Issue priority

{{issuePriorityAvatar}}

Link to issue priority avatar

{{issueLabels}}

List of issue labels

{{issueAttachmentsList}}

List of attachments name

{{issueStatus}}

Issue status

{{issueStatusChangeDate}}

Issue status change date

{{issueCreatedDate}}

Issue created date

{{issueUpdatedDate}}

Issue updated date

{{issueDueDate}}

Issue due date

{{issueLastViewedDate}}

Last date when Issue was viewed by current user

{{issueWatchesCount}}

Issue watches count

{{issueTimeEstimate}}

Issue time estimate

{{issueTimeOriginalEstimate}}

Issue time original estimate

{{issueTimeSpent}}

Issue time spent

{{issueCreatorDisplayName}}

Issue creator display name

{{issueCreatorLink}}

Link to issue creator

{{issueCreatorAvatar}}

Link to issue creator avatar (32x32)

{{issueAssigneeDisplayName}}

Issue assignee display name

{{issueAssigneeLink}}

Link to issue assignee

{{issueAssigneeAvatar}}

Link to issue assignee avatar (32x32)

{{issueReporterDisplayName}}

Issue reporter display name

{{issueReporterLink}}

Link to issue reporter

{{issueReporterAvatar}}

Link to issue reporter avatar (32x32)

{{issueCommentsTotal}}

Issue comments total

{{issueCommentsSeparatedByEmptyLine}}

List of the comments(author, creation date, comment body) separated by empty line

Issue comment

These values ​​must be located in a wrapper (eg li, tr, etc.) with id = "foreach" attribute. The wrapper with this attribute value will be iterated {{issueCommentsTotal}} times (displays all issue comments)

{{issueComment.body}}

Comment body (html format)

{{issueComment.bodyMarkup}}

Comment body (markup format)

{{issueComment.createdDate}}

Comment creation date

{{issueComment.updatedDate}}

Comment update date

{{issueComment.authorDisplayName}}

Comment author display name

{{issueComment.authorLink}}

Link to the profile of the comment author

{{issueComment.authorAvatar}}

Link to comment author avatar (32x32)

{{issueComment.updateAuthorDisplayName}}

Name of the person which was last who updated the comment

{{issueComment.updateAuthorLink}}

Link to the profile of the person which was last who updated the comment

{{issueComment.updateAuthorAvatar}}

Link to the avatar (32x32) of the person which was last who updated the comment

Issue Custom Field

First, you need to know the exact custom field ID, e.g. customfield_10128. After that, you can use the double brace syntax and type {{customfield_10128}} or any other custom field ID.

User

{{currentUserDisplayName}}

Current user display name

{{currentUserLink}}

Link to the profile of current user

{{currentUserAvatar}}

Link to current user avatar (32x32)

You can enable/disable all custom templates. However, the default templates can’t be deleted or edited.