Configure internal notifications in team-managed projects
5 min
Intermediate
By the end of this lesson, you'll be able to:
- Describe the difference between internal notifications and customer notifications
- Configure notifications for a team-managed project
- Describe events and roles used to configure notifications
- Troubleshoot project notifications
Configure internal notifications
In team-managed projects, project admins configure notifications by selecting which events you’d like to notify different users. You can also configure which email the notifications are sent from. Some default notifications already exist, depending on your project template. You can add more notifications as well as edit and delete existing ones.
All project notifications in Jira use email, but you can also integrate a messaging app, like Slack or Microsoft Teams.
In service projects, event-based notifications are called internal notifications and are only sent to members of your service project. These are different customer notifications, which send to customers.
To configure internal notifications:
- In project settings, in the sidebar, select Notifications, then Settings. If you’re in a service project, select Notifications, then Internal notifications.
- Select Add notification to add a notification for another event.
- Next to any existing notification, select More actions (•••), then Edit to change that notification’s recipients.
- Next to any existing notification, select More actions (•••), then Delete to stop notifying any users about that event.
There are many events and recipients you can choose.
👇Click the tabs below to explore your options.
You can configure notifications for these events:
- A work item is created
- A work item is edited
- You’re assigned to a work item
- A work item is deleted
- A work item is moved
- Someone made a comment
- A comment is edited
- A comment is deleted
- Work is logged
- A work log entry is edited
- A work log entry is deleted
In service projects, requests are work items.
Users can enable and disable some notifications through their personal notification settings. Even if you configure a notification in your project, depending on how they configured their personal settings, they might not receive emails for that event.
Let’s explore an example!
Carlos is the project admin for a team-managed project. He does not want to receive notifications when work logs are deleted. The sole exception to this request is Alex, the team resource manager.
To meet this requirement, Carlos should:
- Create a new role called “Resource Manager" and grant the appropriate permissions.
- Assign the role to Alex.
- Add the Project Role "Resource Manager" to the "A worklog is deleted" event.
- Remove all other recipients from the "A worklog is deleted" event.
Troubleshoot notifications
If users aren’t receiving notifications as they should, consider these questions:
- Is the user in the correct role?
- Is the notification being sent to the correct role?
- Has the notification been deleted?
- Did the user opt out of notifications in their personal settings?
These are the most common reasons notifications aren’t sending as intended. Once you’ve validated each item, make the notification event happen and see if your notification sends.