Default and supported notifications

VSTS | TFS 2018 | TFS 2017.1

Default subscriptions are configured 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.

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

Default subscriptions only send targeted notifications. That is, recipient will always be 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 generate a notification to all subscribers by default. To unsubscribe from any one notification, see Unsubscribe from a notification.

Within the personal notifications page, OOB subscriptions appear with the following image: OOB 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 are added to a pull request or when a user is added or removed from a pull request 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 you created or a discussion you are involved in
Code (TFVC) Code review A code review I am 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 team project Notifies you when the area path for a work item is moved to another team project
Work Work item A work item assigned Notifies you when you are 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. To learn more, 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 filewith a specific extension is checked in
Code (TFVC) A file under a specific path is checked in
Code (TFVC) A code review I am 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