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

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.

Set alerts for your team

  1. Open team alerts from Manage TFS Alerts.

    Open team alerts

  2. Expand the team and open Select New Alert Template.

    Work Item Alerts link on the Alerts admin page

  3. Choose an alert type.

    Choose an alert type for the team

  4. Notice how the subscriber is set to the team context. Alerts are sent to each team member based on their preferred email address, which they set through their profile.

    Subscriber set to team context

    Tip

    For the team context, the alert query interprets the @Me variable as anyone who is a member of the team.

You can set filters for as many as 20 different alert types, specify the email addresses for yourself and other team members, and select the delivery format. Also, you can set team alerts to keep all team members notified of important changes.

Set alerts for a project

To set alerts for a project, you must be a member of the Project Collection Administrators or Azure DevOps Serer Administrators groups. To get added, see Change project collection-level permissions. If you're not a member of these groups, you won't see the options available for administering alerts.

As an administrator, you can view, create, edit, and delete alerts for team members and teams.

View alerts set for a project

  • From the web admin page for a project, open the Alerts tab and expand All alerts.

    Expand All Alerts

Find alerts set for a team member or team

  • Choose the name of the team member from the drop-down list, or type the name in the search box.

    Choose the team member whose alerts you want to edit

    Alerts listed for selected team member

Create, edit, or delete an alert

  1. To create an alert for a team member, first find the alerts defined for that subscriber as described in the previous step. Then, create an alert in the same way that a team member creates alerts.

    Create an alert for a team member

    To create an alert for a team, first find the alerts assigned to that team, and then create an alert in the same way. The team should appear in the Subscriber field.

  2. To edit or delete an alert, open it from the short cut menu.

    Open or delete an alert for a team member

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.

Screenshot of unsubscribe from 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.