Manage notifications for a team, project, or organization
TFS 2017 | TFS 2015 | TFS 2013
Your team, project, or organization can receive email notifications as changes occur to the following items in Azure DevOps:
- work items
- code reviews
- pull requests
- source control files
- builds
For example, when a high priority work item is assigned to your team's area path, a notification email gets sent to the team. For more information, see Notification types.
Note
The notifications user interface changed with TFS 2017 Update 1. If you are working on TFS 2017 or earlier version, change the content version selector for this article to TFS 2015.
Prerequisites
To manage notifications, you must be an administrator at the level you want to manage them:
- Team administrator to modify subscription for a team
- A member of the Project Administrators group to create or modify subscriptions for a project.
- A member of the Project Collection Administrators group to create or modify subscriptions for an organization orcollection.
If you're not an administrator, get added as one. See Add a team administrator, Change permissions at the project-level, or Change permissions at the organization or collection-level.
Note
For on-premises Azure DevOps Server, configure an SMTP server for team members to see the Notifications option from their organization or user profile menu and to receive notifications.
Create an email subscription
A subscription lets you control what your team is notified of and how the team receives those notifications. For more information, see notification types.
Open the Notifications page in Team settings:
https://dev.azure.com/{organization}/{project}/_admin/_notifications?view=contents
Select New subscription.
Select the type of activity you want your team to be notified of.
Provide a description to help you identify the subscription later.
Choose which team members should receive a notification:
Choose from one of the following delivery options:
Deliver to Description Members of Azure DevOps by role Only certain team members associated with the event are notified. For example, for work item changes, you might only want the current assignee of the work item to receive a notification. Team preference use the team's default delivery preference. For more information, see Manage delivery settings. Custom email address Send an email to a specified email address. Members of Azure DevOps Send an individual email to each member of the team. SOAP Send to an email address. See the following roles and their descriptions:
Roles Description For certain activities, when you select Team members by role, you can choose to have the user that initiated the activity receive a notification. This notification is controlled by the Skip initiator checkbox. By default, this box is checked, meaning the user that starts the change isn't notified about it.
Choose whether you want to receive notifications about activity in all projects or only a specific project.
Optionally, configure additional filter criteria.
Select Finish to save the new subscription.
Tip
If you don't want to receive a notification for an event that you initiated, you can turn on the option, Skip initiator. For more information, see Exclude yourself from notification emails for events that you initiate.
Manage global delivery settings
Global notifications apply to all projects defined for an organization or collection. Choose to allow or block delivery of emails for all subscriptions owned by a team or a group. It's a default setting which applies only if the team or group hasn't explicitly set the option. For more information, see Global notifications.
Tip
You can send an email to all collections in an application tier. See Configure an SMTP server and customize email for alerts and feedback requests.
Sign in to your organization (
https://dev.azure.com/{yourorganization}).Select
Organization settings.
Select Global notifications > Subscribers, enter and find your group, and then select Delivery settings.
Choose which option best fits your group's needs, and then select Save.
Your group delivery settings are updated for notifications.
Manage team and project delivery settings
Sign in to your organization (
https://dev.azure.com/{yourorganization}).Select Project settings > Notifications.
Choose Delivery settings:
Choose which option best fits your team's needs.
Your team delivery settings are updated for notifications.
Unsubscribe or opt out of a team or out-of-box (OOB) notification subscription
You can choose to not receive notifications for certain team notification subscriptions by opting out.
To unsubscribe from any notification, slide the state On/Off indicator ot the Off position. For example, here we turn off the "Build completes" notification subscription.
Note
Whether or not you're an administrator, when you move the toggle for a shared team notification subscription in your settings only impacts you and not other team members.