This article is only relevant to customers who opted in to the early access program (EAP) for Jira’s new email notifications experience. Based on the success of EAP, the feature should be generally available to all customers early 2024.
Hey there!
We’re pleased to announce exciting improvements to the way you configure your Jira email notifications. To get started, ensure you have enabled email notifications so you can get notified on important issue activity.
When you go to your Personal settings page, it will now open a navigation side bar with two options.
General is where your usual personal settings are located.
Notifications is the new home for all your Jira notification settings.
Feedback was telling us that the previous experience didn’t offer enough control when it came to choosing what email notifications you actually want to receive, so we gave notifications its own space that’s easy to find, and we’ve given you way more options for configuring them.
Previously, you were notified about all issue activity for relevant issues. but you were able to configure what issues you considered relevant by choosing to get notified about issues that:
You’re watching
You’re assigned to
You’re the report on
You’re mention on
You’ve made changes to
The new experience allows you to select issue activity (see the table below for a full breakdown) that you’d like to be notified for but you will no longer have control over what issues are relevant to you. We consider an issue relevant to you if you're watching it, or if you’re the issue’s reporter or assignee. However, this can vary based on your project’s notification settings. Learn more about how this works here.
Here is a full list of configuration options you have in the new Notifications page in you Personal settings.
Types of issue activity | Details |
---|---|
You’re assigned to an issue | When this setting is off, users will not receive emails for when their team mate has assigned them to an issue. |
An issue is deleted | When this setting is off, users will not receive emails when a relevant issue is deleted. |
An issue is edited | When this setting is off, users will not receive emails when a relevant issue has had its field edited. |
Someone makes a comment | When this setting is off, users will not receive emails when a new comment is made on a relevant issue. |
A comment is edited | When this setting is off, users will not receive emails when a comment is edited on a relevant issue. |
A comment is deleted | When this setting is off, users will not receive emails when a comment is deleted on a relevant issue. |
You’re mentioned on an issue | This option cannot be configured. You will always receive a notification if someone @ mentions you on an issue. |
User preferences will apply a filter on top of a project’s notification settings
Admins can still configure their project notification settings/schemes to define the target audience group who should receive a notification for the specified Jira issue events. But users have ultimate control over whether or not they should receive an email through their personal preferences.
Old experience | New experience |
---|---|
Project admins can configure which notifications should be sent to which groups of users. | Project admins can configure which notifications should be sent to which groups of users. |
Users could override these by turning off all notifications if they were a part of the watcher, assignee, or reporter group. |
Users cannot customise their notification preferences based on the groups or roles they belong to. Instead, they can override project settings by turning off emails for specific types of notifications relating to issue activity. |
Removal of Notification Helper admin tool
We’ve also removed the Notification Helper admin tool as we transitioned to this new notification model. We recognise the importance of this tool in providing admins visibility into users' notification preferences to assist in troubleshooting email notification issues, however, we’re aware that there were some problems and limitations which didn’t provide the complete picture. Instead, we recommend using an alternative functionality where admins can log in as another user to impersonate them and view their notification configuration setup to help troubleshoot. We are also exploring a public feature request “Provide a log for Jira outbound email” to provide users with another tool for troubleshooting email notification delivery. Please watch and vote for this issue to stay tuned for further updates!
Eric Zheng
13 comments