Jira applications can generate email notifications for various events that happen throughout the lifecycle of an issue, including custom events. Notifications are defined within a notification scheme (see below), which associates particular events with particular email recipients. The notification scheme is then assigned to a particular project.

You can use the same notification scheme for more than one project.

Default notification scheme

Jira applications are pre-packaged with a notification scheme called the Default notification scheme:

• This scheme is associated with all new projects by default. This means that if you have an outgoing (SMTP) mail server set up, email notifications will be sent as soon as there is any activity (e.g. issues created) in the new project.
• You can disassociate this notification scheme from the project via the Project summary page, as described below.
• You can modify this scheme, or create other notification schemes for particular projects.

Managing notifications schemes

Create a notification scheme

1. In the upper-right corner of the screen, select Administration  > Issues.
   
   
2. In the sidebar, select Notification schemes to open the Notification schemes page, which lists all the current notification schemes in your Jira installation.
3. Start creating the new notification scheme, by doing either of the following:
   
   • Select the Copy link to copy an existing notification scheme. If you have a notification scheme whose event recipients are reasonably similar to what you require, creating a copy is the quickest way to add a new scheme.
     OR
   • Select the Add notification scheme button. On the Add notification scheme page, enter a name for the notification scheme and a short description of the scheme.
4. If you added a new notification scheme or you copied an existing one but have clicked the Edit link to modify the automatically generated name and/or description of the copied notification scheme:
   
   1. Enter a name (or modify the existing one) for the notification scheme (e.g. "Angry nerds Nnotification scheme").
   2. (Optional) Enter a description (or modify the existing one) for the notification scheme.
   3. Select the Add button to create the notification scheme.
5. Add notifications/recipients as described below.
6. Associate your new notification scheme with a project as described below.

Add an event recipient to a notification scheme

To add a new recipient for a particular event:

1. In the upper-right corner of the screen, select Administration  > Issues.
2. In the sidebar, select Notification schemes to open the Notification schemes page, which lists all the current notification schemes in your Jira installation.
3. Find your notification scheme, and click its linked name to open the Edit notifications page.
   The Edit notifications page lists all of the events , along with the recipients who will receive notifications when each event occurs.
4. Select Add in the appropriate event row (see the list of events below), which opens the Add notification page, where you can choose who to notify (about the event) from the list of available recipients (see below).
5. Select the appropriate recipient (filling in any required information for your particular choice of recipient).
6. Select Add. You are taken back to the Edit notifications page (see above), with the notification you just specified now listed against the appropriate issue event.
7. If you make a mistake, or you would like to remove who is being notified, simply click the Delete link beside the person/group/role.

Associate a notification scheme with a project

1. In the upper-right corner of the screen, select Administration  > Projects.
2. In the sidebar, select Notifications and then select the name of the current scheme (e.g. Default notification scheme) or None (if the project is not yet associated with a scheme) to display details of the project's current notification scheme.
3. Select the Actions dropdown and choose Use a different scheme (or Select a scheme).
4. On the subsequent Associate notification scheme to project page, which lists all available notification schemes, select the notification scheme you want to associate with the project and click the Associate button.

Events

Jira applications support the following events, which can generate email notifications (as defined in a notification scheme).

Recipients

The following types of recipients can receive email notifications.

Consider that:

• Email notifications will only be sent to people who have permission to view the relevant issue — that is, people who:
  
  • have the Browse Projects project permission for the project to which the issue belongs; and
  • are members of any issue security levels that have been applied to the issue.
• Jira can only send email notifications if SMTP email has been enabled (see Configuring email notifications).
• Jira's default setting is to not notify users of their own changes. This can be changed on a per user basis via their profile preferences.
• Each event is sent in a separate email, but you can enable batching of email notifications to get similar events grouped in a single summary email.