Manage notifications for a team

Azure Boards | Azure DevOps Server 2019 | TFS 2018 | TFS 2017

Note

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 in order for team members to see the Notifications option from their organization menu and to receive notifications.

As changes occur to work items, code reviews, pull requests, source control files, and builds, your team can be notified via email. For example, when a high priority work item is assigned to your team's area path, an email can be sent to the team.

Create a custom email subscription

A subscription lets you control what your team should be notified about and how the team receives those notifications.

  1. Open the Notifications page under team settings: https://dev.azure.com/{organization}/{project}/_admin/_notifications?view=contents

    Navigate to team notifications page

    Navigate to team notifications page

  2. Select New subscription. If you're not a team administrator, get added as one. You need to be a team, project, or project collection administrator to create team alerts.

    New subscription

    New subscription

  3. Select the type of activity you want your team to be notified of.

    Select event category and template

  4. Provide a description to help you identify the subscription later.

    Select event category and template

  5. Choose which team members should receive a notification:

    Select role

    You can choose one of the following delivery options:

    • Team members by role: only certain team members associated with the event are notified. For example, for work item changes, you might only want the current assignee of the work item to receive a notification.
    • Team preference: use the team's default delivery preference. Learn how to manage delivery settings below.
    • Custom email address: send an email to a specified email address.
    • All team members: send an individual email to each member of the team.

    For certain activities and when Team members by role is selected, you can choose to have the user that initiated the activity receive a notification. This is controlled by the Skip initiator checkbox. By default, this box is checked meaning the user that initiates the change is not notified about it.

  6. Choose whether you want to receive notifications about activity in all projects or only a specific project.

    Select scope

  7. Optionally configure additional filter criteria.

    Select scope

  8. Select Finish to save the new subscription.

Manage team delivery settings

Choose the default method for your team to receive notifications by updating the team delivery settings.

  1. Open the Notifications page under team settings: https://dev.azure.com/{organization}/{project}/_admin/_notifications?view=contents

    Navigate to team notifications page

  2. Choose Delivery settings:

    Delivery settings

  3. Choose which option best fits your team's needs:

    Delivery settings options