Manage your notifications

Azure DevOps Services | Azure DevOps Server 2019 | TFS 2018 | TFS 2017 | TFS 2015 | TFS 2013

As changes occur to work items, code reviews, source control files, and builds, you can receive email notifications for alerts that you define. 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. You can set personal alerts, as described in this article, or team or project alerts.

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.

In this tutorial, learn how to do the following tasks:

  • View your notifications
  • Add a custom subscription
  • Unsubscribe or opt out of a team or project subscription

Note

For on-premises Azure DevOps Server, you must configure an SMTP server in order for team members to see the Notifications option from their organization or user profile menu and to receive notifications.

View your personal notifications

Note

To enable the new user interface for the Project Permissions Settings Page, see Enable preview features.

From the web portal, select the icon with your initials or picture, and then select Notification settings from the drop-down menu.

Navigate to personal notifications page

Navigate to personal notifications page

Set alerts just for yourself

  1. Open alerts management (My alerts from your profile menu). If you don't see this option, then you must configure an SMTP server to support TFS.

    Manage individual alerts from the web portal

  2. Enter one or more email addresses. Separate addresses with a semi-colon.

    Set email address for alerts

  3. Select the check box for each alert of interest. My work items and My build refer to work items and builds that you created.

    Manage TFS alerts

    Alert templates reference a customizable query.

    The following alert types appear when your project is provisioned with Git for version control:

    • A commit is pushed to this project
    • A pull request I've participated in is created or updated
    • A build quality changes

    Tip

    When you clear an alert, you also clear all email addresses defined for the alert.

  4. For more options, open custom alerts and choose one of the options available. Also, you can open a basic alert and modify its settings, such as changing the email format from HTML to plain text or SOAP.

    Open custom alerts

  5. Define alert filters in the same way you define query filters.

    Fill out the custom alerts form

    For a list of available fields, see Index of work item fields.

  6. For even more options, open the Select New Alert Template.

    Open all alert options

  7. Choose from one of the several alert types listed.

    Choose an alert type from all options listed

View all subscriptions

This view shows all subscriptions that you've created or that have been created by an administrator. Subscriptions let you control what you are notified about. Subscribed notifications are indicated with the State as On.

Note

To enable the new user interface for the Project Permissions Settings Page, see Enable preview features.

Personal notification subscriptions

A subscription can be just for you, or if you're 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. A custom subscription can notify you about any event. Default subscriptions differ, as they only notify users or groups directly associated with an event.

Note

To enable the new user interface for the Project Permissions Settings Page, see Enable preview features.

  1. From your Notifications page, select New subscription.

    Open the new subscriptions dialog

  2. 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.

    New subscription dialog
  3. 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.

    Updated subscription dialog with field criteria

    Note

    The fields available for filtering event criteria differ depending on the category and template you select.

  4. Select Finish when you're done. The subscription now appears in the list under the category you selected.

    New subscription added

Open the new subscription dialog
  1. 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.

    New subscription dialog
  2. 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.

    Updated subscription dialog with field criteria

    Note

    The fields available for filtering event criteria differ depending on the category and template you select.

  3. Select Finish when you're done. The subscription now appears in the list under the category you selected.

    New subscription added

Unsubscribe or opt out of a team or OOB subscription

You can choose to not receive notifications for certain team subscriptions by opting 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.

Unsubscribe from Build completes subscription

Note

Whether you are an administrator or not, toggling a shared team subscription from your notification settings only impacts you and not other team members.

Limitations

  • The user interface no longer supports creating plain text email subscriptions.