Manage your personal notifications

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013

You can manage your personal notifications in the following ways:

  • View your notifications
  • Set notifications just for yourself
  • View and edit all notification subscriptions
  • Add a custom notification subscription
  • Unsubscribe or opt out of a team or project notification subscription

Personal notifications get sent to you in the form of an email as changes occur to builds, code, pipelines, work, artifacts, extensions, releases, and more.

For information about team and project-level notifications, see Team and project-level notifications and Manage team or group notifications.

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.

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.

Prerequisites

View your personal notifications

The following table shows notification event examples. For more information, see a full representation in About notifications.

Item Notification event examples
Work item assigned, unassigned, comments
Code reviews updated, completed
Pull request added or removed reviewer, completion failure, comments
Source control file created, updated
Build completion success, completion failure

To access the Preview features options, open your profile menu. The profile menu appears, as shown, based on whether the New Account Manager feature is enabled.

  1. Sign in to your organization (https://dev.azure.com/{yourorganization}).

  2. Select User settings, and then select Notifications from the resulting list.

    Preview page of personal notifications.

Go to the personal notifications page.

Set personal alerts

In this context, an alert is effectively the same as a notification.

  1. Open My alerts from your profile menu. If you don't see this option, then 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.

    Open custom alerts for more options. Also, you can open a basic alert and modify its settings, such as change the email format from HTML to plain text or SOAP.

    Open custom alerts

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

  5. For even more options, select Others..., and then choose Select New Alert Template.

    Open all alert options

  6. Choose an alert type from the several alert types listed, and then select OK.

    Choose an alert type from all options listed

View and edit all notification subscriptions

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

To access the Preview features options, open your profile menu. The profile menu appears, as shown, based on whether the New Account Manager feature is enabled.

Screenshot of unsubscribe from notification subscriptions.

A notification subscription can be just for you. Or, if you're a team administrator you can ensure that it's shared by everyone on the team.

Add a custom notification subscription

With custom personal notification subscriptions, you can define precise criteria for the events that you want to receive notifications. A custom notification subscription can notify you about any event. Default notification subscriptions differ, as they only notify users or groups directly associated with an event.

To access the Preview features options, open your profile menu. The profile menu appears, as shown, based on whether the New Account Manager feature is enabled.

  1. From your Notifications page, select New subscription.

    Screenshot of New notification subscription selected.

  2. Choose the category and template that you want to use, and then select Next. 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.

    Screenshot of new notification subscription-selected category and template.

  3. Modify the description to help you identify the notification subscription later. Also, choose an email address for the 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. Select Finish when you're done.

    Screenshot of updated notification subscription dialog with field criteria.

    Note

    The fields available for filtering event criteria differ depending on the category and template that you select. For more information about event types, see Supported event types.

    The new notification subscription appears in the list under the category that you selected.

    Screenshot of confirmation of new subscription added.


Screenshot of the new notification subscription.

  1. Choose the category and template that 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 notification subscription dialog.

  2. Modify the description to help you identify the notification 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 notification subscription dialog with field criteria.

    Note

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

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

    New subscription added.

Unsubscribe or opt out of a team or out-of-box (OOB) notification subscription

You can choose to not receive notifications for certain team notification subscriptions by opting out.

To access the Preview features options, open your profile menu. The profile menu appears, as shown, based on whether the New Account Manager feature is enabled.

  1. Sign in to your organization (https://dev.azure.com/{yourorganization}).

  2. Select User settings, and then select Notifications from the resulting list.

    Screenshot of personal notifications, preview page.

  3. To unsubscribe from any notification, slide the state On/Off indicator ot the Off position.

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.

Next steps

Limitations

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