Manage notifications in your Jira and Service Management. Use JQL queries or apply default Jira filters to create personalized notifications for a specific group of people.
.png?version=1&modificationDate=1617629545752&cacheVersion=1&api=v2)
| Info |
|---|
Please, remember to log in to your Jira instance with Administration access so you can manage Notification Assistant and create email templates. To learn more, read Installation Guide |
| Table of Contents |
|---|
How to set up your notification in Notification Assistant for Jira Cloud
To set up notifications in Notification Assistant, go to the Project Settings and select “Apps“. Scroll down to find the "Notification Assistant" and click on it. Configure your notification following the steps described below.
.png?version=1&modificationDate=1617626792928&cacheVersion=1&api=v2)
Edit Notification Details
Notification Name. Provide a unique name for your notification in this required field. You will see the name you provide in the notification email.
Description. If you like, you can provide your notification with a description to remember the notification's purpose.
Configure Triggers
Determine when the notification should fire and in which interval.
| Note |
|---|
You can only use one type of trigger configuration for each Notification. |
Weekly. Select how often, at what time interval, and on which days the notification will fire.
Event. You can choose trigger by events. You may choose the notification to respect the "Do not notify me" settings in the Jira user profile.
Tip: Remember that too many or low value notifications may be consider spam by your recipient.
JQL Expression
Custom JQL. Write any JQL expression to fire your custom notification. To learn more about JQL syntax, read Advanced Searching.
Add Recipients
You can pick recipients from People, Users, Groups, Project Roles, Custom Fields, or enter their hardcoded email addresses. To add recipients, click on the “Configure Recipients” tab and choose the required checkboxes in a modal window. Select whether you like to send one email to all recipients or a personal email per recipient.
| Info |
|---|
Recipients that are email addresses in custom fields, or hardcoded in the Email tab do not need to be licensed Jira users. However, this also means we can’t perform permission checking. Please be careful with how you use this functionality. |
People. In this tab, you can add Assignee, Reporter, Watchers, or Voters to the recipient list.
Users. In this tab, you can specify Jira Users to receive notifications. Enter a user name in the user picker.In case you add a Jira user who has no access to the issue or project you configured in the notification, this user won’t be notified. If you need to notify this person anyway, add their hardcoded email address.
Groups. Select one or more Jira groups to receive notifications. Your notification email will be sent to every recipient separately, not as a group letter in your email agent. See more about user groups in the Managing groups section.
.png?version=1&modificationDate=1617628323825&cacheVersion=1&api=v2&width=421)
.png?version=1&modificationDate=1617628323825&cacheVersion=1&api=v2&width=414)
Roles. You can select one or more Jira Project Roles to receive notifications. For example, it could be Developers, Administrators, Service Management Customers, or Service Management Team. See more about roles on the Managing project roles page.
Custom Field. To add recipients from custom fields, you can choose a custom field of type "Text Field," "User Picker," "Multi-User Picker," "Group Picker," "Multi-Group Picker" and "JSM Request Recipients" to be the recipient. The custom field of type "Text Field" needs to be populated with one or many valid comma-separated email addresses for notifications to be sent. You can add custom fields in the administration menu "Issues / Fields." See more about custom fields on the Adding a custom field page.
Email. Whether it’s a licensed Jira user or an external recipient, you can specify one or many email addresses separated by a comma to notify these people.
Choose Email Template
If you’d like to notify your recipients via email, you can apply a template to the notification. The list of available email templates is visible in a drop-down menu. You can use Default Email Template or create personalized email templates in the new drag-and-drop template editor (available from version 7.0).
We recommend you use our Create Email Template docs to create a default Issue Details Template and a Comment template which can be used with the associated issue events.
Advanced Notification Settings
In the Advanced Notification Settings, select the template theme to the notification. The list of available email templates is visible in a drop-down menu. You can use Table Template, Single Issue Template, Comment Template, or create a personalized one in the drag-and-drop template editor.
Mark the checkbox if you need your notification to include attachments in emails.
Click Save and you’re done!