Advanced Details With Placeholders
You can use these dynamic "placeholders" to show the actual values that you want the recipient to see. The placeholders can be used in the notification subject, message, and footer, but also in Hipchat, Slack, or any REST-API call.
For issue specific placeholders, this is more interesting if you are using the EVENT trigger configuration.
If you are using issue placeholders without the event trigger, it will choose the value from the first issue in the result set.
The supported placeholders:
Place holder | Issue placeholder | Description |
|---|---|---|
| ${username} | No | Gives you the JIRA username of the recipient. Note that this will not apply to external recipients! |
| ${fullname} | No | Gives you the full name of the JIRA user recipient. Note that this will not apply to external recipients! |
| ${emailaddress} | No | Gives you the email address of the user recipient. |
| ${summary} | Yes | Gives you the issue summary of the first issue in the notification. Handy in event mode! |
| ${key} | Yes | Gives you the issue key of the first issue in the notification. Handy in event mode! |
| ${created} | Yes | Gives you the issue created date of the first issue in the notification. Handy in event mode! |
| ${updated} | Yes | Gives you the issue updated date of the first issue in the notification. Handy in event mode! |
| ${assignee} | Yes | Gives you the issue assignee of the first issue in the notification. Handy in event mode! |
| ${assignee.username} | Yes | Gives you the issue assignee username of the first issue in the notification. Handy in event mode! |
| ${assignee.fullname} | Yes | Gives you the issue assignee of the first issue in the notification. Handy in event mode! |
| ${assignee.emailaddress} | Yes | Gives you the issue assignee email address of the first issue in the notification. Handy in event mode! |
| ${issuetype} | Yes | Gives you the issue type of the first issue in the notification. Handy in event mode! |
| ${priority} | Yes | Gives you the issue priority of the first issue in the notification. Handy in event mode! |
| ${project} | Yes | Gives you the project for the issue of the first issue in the notification. Handy in event mode! |
| ${reporter} | Yes | Gives you the reporter of the first issue in the notification. Handy in event mode! |
| ${reporter.username} | Yes | Gives you the issue reporter username of the first issue in the notification. Handy in event mode! |
| ${reporter.fullname} | Yes | Gives you the issue reporter of the first issue in the notification. Handy in event mode! |
| ${reporter.emailaddress} | Yes | Gives you the issue reporter email address of the first issue in the notification. Handy in event mode! |
| ${status} | Yes | Gives you the status of the first issue in the notification. Handy in event mode! |
| ${resolution} | Yes | Gives you the resolution of the first issue in the notification. Handy in event mode! |
| ${description} | Yes | Gives you the description of the first issue in the notification. Handy in event mode! |
| ${environment} | Yes | Gives you the environment of the first issue in the notification. Handy in event mode! |
| ${affected_versions} | Yes | Gives you the affected versions of the first issue in the notification. Handy in event mode! |
| ${fix_versions} | Yes | Gives you the fix versions of the first issue in the notification. Handy in event mode! |
| ${components} | Yes | Gives you the components of the first issue in the notification. Handy in event mode! |
| ${labels} | Yes | Gives you the labels of the first issue in the notification. Handy in event mode! |
| ${event.type} | No | In event mode, you can use the event type like "updated" or "commented" in your notifications. Only available in event mode. |
| ${event.username} | No | In event mode, you can set the username of the user firing this event. Only available in event mode. |
| ${event.fullname} | No | In event mode, you can set the full name of the user firing this event. Only available in event mode. |
| ${lastcomment.body} | Yes | Gives you the body of the last comment on the issue of the first issue in the notification. Handy in event mode! |
| ${lastcomment.time} | Yes | Gives you the time of the last comment on the issue of the first issue in the notification. Handy in event mode! |
| ${lastcomment.author} | Yes | Gives you the author of the last comment on the issue of the first issue in the notification. Handy in event mode! |
| ${<customfield-name>} | Yes | Gives you a custom field value from a supported custom field. Replace <customfield-name> with the specific Custom Field Name. |
${customfield_XXXXX} | Yes | Gives you a custom field value from a supported custom field. Replace XXXXX with the specific Custom Field ID. |
| ${jql} | No | Gives you the JQL configured for the notification |
| ${notification.name} | No | Gives you the name of the notification |
| ${notification.id} | No | Gives you the ID of the notification. Useful for creating links back to the notification for troubleshooting. VERSION 6.3.0+ |
| ${notification.jql} | No | Gives you the JQL configured for the notification |
| ${notification.description} | No | Gives you the description of the notification |
| ${baseUrl} | No | Gives you the Base URL of Jira with the context path. Useful for creating links to content in Jira. VERSION 6.3.0+ |
| ${issuecount} | No | Total number of issues in the Notification. |