Placeholders
If you need more advanced functionality than what can be done in the editor today, you can also use Placeholders within a Template to further customize the email.
If the email includes multiple issues, then the placeholder will only show the value from the first issue to be included.
Placeholder | Notes |
---|---|
${recipient.displayname} | If the recipient is an email address and not a Jira user, then this will show the email address. |
${recipient.emailaddress} |
|
${created} |
|
${updated} |
|
${assignee} |
|
${assignee.username} | Shows the Display Name of the issue Assignee. |
${assignee.emailaddress} |
|
${summary} |
|
${key} |
|
${issuetype} |
|
${priority} |
|
${project} |
|
${status} |
|
${resolution} |
|
${reporter} |
|
${reporter.username} |
|
${reporter.emailaddress} |
|
${components} |
|
${labels} |
|
${lastcomment.body} |
|
${lastcomment.time} |
|
${lastcomment.author} |
|
${customfield_12345} | Embeds a custom field value into an email. We currently support Standard custom field types. We’re working on formally supporting all custom field types. |
${event.type} | Only available during when an email is triggered by an issue event. An example value would be: updated an issue |
${event.username} | Only available during when an email is triggered by an issue event. |
${notification.name} | Shows the name of the Notification sending the email. This is helpful in understanding what is triggering an email to be sent to a user. |
${notification.id} | Shows the ID of the Notification sending the email. |
${notification.jql} | Shows the JQL of the Notification sending the email. |
${notification.description} | Shows the Description of the Notification sending the email. |
${baseurl} | Shows the Base URL for Jira. This is helpful in building links back to Jira. |
${projectUrl} | Shows the URL to the project in Jira. Can only be used when adding links to fields. |
${issueUrl} | Shows the URL to the Issue in Jira. Can only be used when adding links to fields. |
${issuecount} | Shows the total number of issues in the email. |