Configuring email notifications

Still need help?

The Atlassian Community is here for you.

Ask the community

Jira can send email notifications to users when significant events occur (e.g. creation of an issue; completion of an issue).

Before you begin

You must be logged in as a user with the Administer Jira global permission.

Email notifications

Enabling email notifications

The email address from which notifications are sent can also be configured for each project. See Creating a notification scheme for more information.

Disabling email notifications

Jira projects use notification schemes to send email notifications about project activity. There are two ways to disable email notifications for a given project:

  1. Remove the notification scheme entirely from a project. 
  2. Edit a project's notification scheme so that no emails are sent. Take care when editing a scheme as more than one project may be using it. Read more about creating and editing a notification scheme.

To remove a notification scheme from a project:

  1. From your project's sidebar, select Project settingsNotifications.
  2. Select ActionsUse a different scheme.
  3. In the Schemes dropdown, select None.
  4. Select Associate.

Configuring a project's email address

It is possible to configure a project's email address, which is the email address that notifications are sent from – i.e. the 'sender address'. This will also serve as the reply address for responses, which can work in conjunction with Creating issues and comments from email.

By setting the Sender Address for a project, all notifications will be sent from this address. This setting is specific to the project selected and will not affect the configuration of the other projects. The From address specified in the SMTP Mail Server configuration is used as the default Sender Address for all projects. See Configuring Jira Cloud to send emails on behalf of your domain for more information.

The 'Sender Address' for a project can be configured as follows:

  1. Choose the Jira icon ( or ) > Projects.
  2. Select Settings Summary.
  3. Under the Notifications section and click the pencil icon to the right of the Email address.
  4. In the resulting Project Email Address dialog box, enter a valid email address in the Email field, and click Update.

This email address will now be used as the sender address in all email notifications sent by this project.

You can revert to the default email address by leaving the Email field blank.

Email recipients

For each event notification, Jira will only send the first encountered email intended for a recipient. Hence, in the case where a user is included in two or more recipient lists (e.g. the Project Lead and current reporter) for one event notification, the user will only receive the first encountered email notification. Jira will log the fact that this user was on multiple recipient lists.

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.

Email HTML formatting

Each Jira user can specify in their personal settings whether to send outgoing emails in text or HTML format. Jira Administrators can specify a default email format:

  1. Choose the Jira icon ( or ) > Jira settings > System.
  2. Select Default user preferences.
  3. Select Edit default values.
  4. In the Email format dropdown, choose either text or html.
  5. Select Update.

Troubleshooting email notifications

The Jira admin helper can help you diagnose why a user isn't receiving email notifications when they should be, or why a user is receiving email notifications when they shouldn't be. This tool is only available to Jira administrators.

To diagnose why a user is or is not receiving notifications for an issue:

  1. Choose the Jira icon ( or ) > Jira settings > System.
  2. Select Notification helper.
Last modified on Jan 6, 2019

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.