Configuring email notifications
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:
- Remove the notification scheme entirely from a project.
- 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:
- From your project's sidebar, select Project settings > Notifications.
- Select Actions > Use a different scheme.
- In the Schemes dropdown, select None.
- 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:
- Choose the Jira icon (, , , or ) > Projects.
- Select Settings > Summary.
- Under the Notifications section and click the pencil icon to the right of the Email address.
- 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:
- Choose the Jira icon (, , , or ) > Jira settings > System.
- Select Default user preferences.
- Select Edit default values.
- In the Email format dropdown, choose either text or html.
- 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:
- Choose the Jira icon (, , , or ) > Jira settings > System.
- Select Notification helper.