Manage your notifications
VSTS | TFS 2018 | TFS 2017.1 | Previous versions
Feature availability: This topic applies to VSTS, TFS 2017 Update 1, and later versions. If you work from an on-premises TFS 2017 or ealier versions, see Set alerts, get notified when changes occur. For on-premises TFS, you must configure an SMTP sever in order 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 to be notified whenever a bug that you opened is resolved or a work item is assigned to you.
Use this topic to learn how to:
- 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, click the icon with your initials or picture icon, and select Notification settings from the drop-down menu.
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, click 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.
Click Finish when 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 opt'ing 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.
- Default and supported notifications
- Follow a specific work item
- Manage notifications for a team
- Change your preferred email address
- The user interface no longer support creating plain text email subscriptions.