Configure a notification

Owned by Mathias Edblom (Unlicensed)
Last updated: Jan 24, 2020 by Boris Berenberg - Atlas Authority (Unlicensed)
6 min read

Set up your first notification

Go to the JIRA administration and the "Manage apps" tab.

On the left side you will find the "Notification Assistant" panel. Click on "Configure Notifications", "Get Started" / "Configure" in the body of the App Menu.

You will see the start screen of the Notification Assistant.

Configure your notification

Enter the values that should be valid for your notification.

AttributeDescription
Notification NameGive your notification a descriptive name, i.e. "Remind assignees 24 hours prior to due date". Cannot be the same as another notification name.
DescriptionGive your notification a description to remember the purpose of the notification.
JQL TypeCustom JQL or saved JIRA Filter
JQL Expression

You can specify any JQL Expression to be the reason to fire the notification. (If JQL Type is set to Custom JQL)
To learn more about JQL syntax, read this: Advanced Searching 

Note that any JQL with user notations like (watchedIssues, votedIssues, etc) will not work, because the JQL is run by a server account.

JIRA FilterSelect the filter you want the notification to use. (If JQL Type is set to JIRA Filter). This is useful if you, as an administrator, want to delegate the possibility to define the JQL to query on.
Minimum issues to trigger notificationHow many issues in the JQL results are required to trigger the notification to be sent.
Maximum times an issue can trigger a notificationThis is how many times an issue can trigger a notification. Once the difference between the value set here and the number of times an issue has been included in this notification is equal to or less than 0, the issue will not be included in future notifications.
Reset issue trigger limitTick this box and click save if you want to reset the issue trigger limit.
Recipient type People

You can specify recipients with certain attributes in the result set to receive notifications. You can configure Assignee, Reporter, Watchers, and Voters.

Recipient type Users

You can select one or more JIRA users to receive notifications.

Recipient type Groups

You can select one or more JIRA groups to receive notifications

Recipient type Project Role

You can select one or more JIRA Project Roles to receive notifications

Recipient type Custom Field

You can choose a custom field of type "Text Field", "User Picker", "Multi User Picker", "Multi Group Picker" or the third party "NFeed Users" and JIRA ServiceDesk "Request Participants" to be the recipients. 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".

Recipient type Email address

You can specify one or many email addresses to be the recipient. It can even be an address not registered in JIRA.

Trigger Configuration

  • Days per Week
  • Days per Month
  • Cron Expression
  • Date/Time Fields
  • Event 
  • Field Edited

Here is where you determine when the notification should fire and in which interval.
Tip: respect the fact that too frequent notifications might be considered spam by the receiver(s) 

You can only use one type of trigger configuration for each notification. Select the configuration you want (active tab), the rest of the tabs will be ignored.

Cron Expression

Cron is powered by the Quartz Scheduler in Java. We recommend using https://www.freeformatter.com/cron-expression-generator-quartz.html to help build and test your Cron expressions.

Trigger by Date/Time Fields

If you choose trigger by Date/Time Fields you have to choose a custom field that triggers the start and optional stop. You can specify the interval the notification should be triggered. No interval means that the notification only triggers once.


Trigger by Event

If you choose trigger by events, in some cases (like "closed" event) make sure you have set the JIRA event in the post function within the transition.

You may choose if you want the notification to respect the "Do not notify me" settings in the JIRA User profile.

Field Edited

Fire a notification whenever a specified field is edited. It is important to note if you have two fields with identical names, there is no way for us to tell them apart on the backend during an issue event. As a result, this can lead to some unintended notifications. You can prevent this by filtering the field in the JQL to reduce the problem.

Email Template

Here is where you specify the email template and some more optional ways of notifying.

Executing User (actor)Specify the user who the notification should run as. This will impact what issues show up in your JQL specified above.
Sender email addressSpecify the "From" email address for this notification. This can be helpful if you want recipients to respond to this email and need it routed to a specific place other than Jira's default outbound email address.

Additional Send Hooks

  • Slack Channel
  • HipChat Room
  • Comment 
  • REST-API

With "additional send hooks" you are able to notify other internal/external systems besides the ordinary email notifications sent out.

Notify a specific Slack Channel.

Please follow the steps in the Slack documentation in order to enable Webhooks from Slack's side and generate a URL.

Notify a specific HipChat room.

Post a comment to the issues found in the result set.

Call a REST-API that makes the notification really powerful.

For example, add or update a page in Confluence, or notify some internal system that need to be triggered in some critical stage.

Use placeholders in the posted data to be able to send data depending on the issues in this notification.


Your configured notifications

See your configured notifications on the main Notification Assistant screen.

Choose to configure, copy, export, delete or execute them right away.


(warning) - This icons means that you don't have an Executing User configured for this notification and that it may behave inconsistently.

(info) - Note that notifications that are configured to use the Event, or Field  trigger configuration cannot be executed right away since they are event driven.

Click the "info" button to get detailed information about the notification:


On this page: