Default and supported notifications

TFS 2017

Configure default subscriptions to send notifications to certain roles or user groups with specific associations to an event. For example, "reviewer" is a role on a pull request event. "Assignee (current)" is a role that reflects the current Assigned To user of a changed work item.

In the description of the default subscription, you can see the roles that receive notifications. For example, "Notifies you when a build you queued or that was queued for you completes". Role-based subscriptions contain a Roles field that you can view by opening the subscription. Only users or groups that belong to the role listed within the subscription receive a notification for an event matched by the subscription.

Default subscriptions only send targeted notifications. That is, the recipient is always somehow associated with the event that triggered the notification. For example, the default subscription for work item updates only sends an email notification to the person assigned to the work item.

Out-of-the-box (OOB) or default subscriptions

The following events send notifications to all subscribers, by default. For more information about unsubscribing from a notification, see Unsubscribe from a notification.

Within the personal notifications page, OOB subscriptions appear with the following image: Notification.

Category Type Build Description
Build Build completed Build completes Notifies you when a build you queued or that was queued for you completes
Code (Git) Pull request Pull request reviewers added or removed Notifies you when you or another user gets added or removed from a pull request that you created
Code (Git) Pull request Pull request completion failures Notifies you when a pull request you created fails to complete
Code (Git) Pull request Pull request changes Notifies you when changes are made to a pull request you created or are a reviewer for
Code (Git) Pull request comment A comment is left on a pull request Notifies you about comments made to a pull request that you created or a discussion you're involved in
Code (TFVC) Code review A code review I'm working on changes Notifies you when a change is made to a code review you're assigned to
Extension management Extension Extensions have been modified. Extensions have been modified.
Extension management Extension request (batch) Extensions are requested or requests are updated. Extensions are requested or requests are updated.
Release Deployment pending Manual intervention pending Notifies you when a manual intervention is pending on you
Release Deployment completed Deployment to an owned environment failed Notifies you when a deployment to an environment you own fails to complete successfully and makes the environment unhealthy
Release Deployment completed Deployment to an approved environment failed Notifies you when a deployment you approved fails to complete successfully and makes the environment unhealthy
Release Deployment completed Deployment completion failures Notifies you when a deployment you requested fails to complete successfully and makes the environment unhealthy
Release Release approval pending Deployment approval pending Notifies you when an approval for a deployment is pending on you
Work Work item A work item is moved from this project Notifies you when the area path for a work item is moved to another project
Work Work item A work item assigned Notifies you when you get assigned or unassigned a work item

Supported subscriptions

You can create subscriptions using the following templates for yourself, a team, or a group. Within the subscription dialog, you can specify additional fields based on the category. For more information, see Manage personal notifications.

Category Template
Build A build completes
Build A build fails
Build A build controller or agent's status changes
Build A build's quality changes
Code (Git) A commit authored by me is pushed
Code (Git) A commit is pushed by me
Code (Git) A commit is pushed
Code (Git) A pull request is created or updated
Code (TFVC) Code is checked in
Code (TFVC) Code is checked in with a policy override
Code (TFVC) A file with a specific extension is checked in
Code (TFVC) A file under a specific path is checked in
Code (TFVC) A code review I'm working on changes
Work A work item I created is changed
Work A work item assigned to me is changed
Work A work item is changed
Work A work item is assigned to me
Work A work item is deleted
Work A work item is restored
Extension management An extension is modified
Release An approval for a deployment is pending
Release A deployment is completed
Release A manual intervention for a deployment is pending