Manage your notifications
Azure Boards | Azure DevOps Server 2019 | TFS 2018 | TFS 2017
Feature availability: This topic applies to Azure DevOps Services, TFS 2017 Update 1, and later versions. If you work from an on-premises TFS 2017 or earlier versions, see Set alerts, get notified when changes occur. For on-premises TFS, you must configure an SMTP server for team members to see the Notifications option from their organization menu and to receive notifications.
As changes occur to your code base, builds, work items, and other operations, you can receive email notifications. For example, you can set an alert, so you're notified whenever a bug that you opened is resolved or you're assigned to a work item.
In this tutorial, you learn how to do the following tasks:
- View your notifications
- Add a custom subscription
- Unsubscribe or opt out of a team or project subscription
View your personal notifications
From the web portal, select the icon with your initials or picture, and then select Notification settings from the drop-down menu.
Your web portal uses either the New navigation or Previous navigation user interface. Choose the New navigation tab if the New Navigation feature is enabled. You'll see a vertical sidebar along with other navigational features when New Navigation has been enabled for the signed-in user or the organization. Choose Previous navigation when you see a top-level, blue-bar—indicating that New navigation isn't enabled. For more information, see Web portal navigation.
Choose the New navigation tab for guidance. Azure DevOps Server 2019 supports the New Navigation user interface. For more information, see Web portal navigation.
Choose the Previous navigation tab for guidance. TFS 2018 and earlier versions only support the previous navigation user interface. For more information, see Web portal navigation.
View all subscriptions
This view shows all subscriptions that you have created or that have been created by an administrator. Subscriptions let you control what you are notified about. Those notifications you're subscribed to are indicated with the State as On.
A subscription can be just for you, or if you are a team admin, can be shared by everyone in the team.
Add a custom subscription
With custom personal subscriptions, you can define precise criteria for the events you want to receive notifications for. In contrast to a default subscription, which will only notify the users or groups directly associated with an event, a custom subscription can notify you about any event.
From your Notifications page, select New subscription.
Choose the category and template you want to use. For a list of supported templates, see Default and supported notifications.
Here we choose to get notified when a pull request is created within a specific project, Fabrikam Fiber.
Modify the description to help you identify the subscription later. Also choose an email address for notifications to be delivered to. By default, your preferred email address is used. optionally, include one or more fields to further specify the event criteria.
The fields available for filtering event criteria differ depending on the category and template you select.
Select Finish when you're done. The subscription now appears in the list under the category you selected.
Unsubscribe or opt out of a team or OOB subscription
You can choose to not receive notifications for certain team subscriptions by opting out of the subscription.
To unsubscribe from any notification, even one that you've defined, slide the State On/Off indicator to the Off position.
For example, here we turn off the Build completes subscription.
Whether you are an administrator or not, toggling a shared team subscription from your notification settings only impacts you and not other team members.
- Set your preferences
- Default and supported notifications
- Follow a specific work item
- Manage notifications for a team
- Change your preferred email address
- The user interface no longer supports creating plain text email subscriptions.