Edit

Share via


Manage your personal notifications

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

There are many ways you can manage your personal notifications in Azure DevOps:

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

You receive personal notifications as email messages when 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

For on-premises Azure DevOps Server, configure an SMTP server so team members can see the Notifications option from their organization or user profile menu and receive notifications.

Prerequisites

Category Requirements
Project access Project member.

View your personal notifications

The following table lists examples of events for which you might receive personal notification email. For more information, see a full representation in About notifications.

Category Notification triggers
Work item - You're assigned a work item
- You're unassigned from a work item
- Comments are added/changed on a work item to which you're assigned
Code reviews - A code review to which you're assigned changes
- A code review to which you're assigned completes
Pull request - You're added or removed as a reviewer on a pull request
- A pull request to which you're assigned fails to build
- Comments are added/changed on a pull request to which you're assigned
Code under source control - A code file is added to a project under version or source control
- A commit is pushed to a code file under version or source control
Build - A build succeeds
- A build fails

Follow these steps to view your personal notifications:

  1. Sign in to your organization (https://dev.azure.com/<organization>).

  2. Select User settings , and then select Notifications:

    Screenshot that shows how to select the User settings, Notifications option in Azure DevOps.

    Your personal Notifications page opens:

    Screenshot showing personal notification subscriptions in Azure DevOps.

  1. Sign in to your organization (https://dev.azure.com/<organization>).

  2. Open User settings, and then select Notification settings:

    Screenshot that shows how to select the User settings, Notifications option in earlier versions of Azure DevOps.

    Your personal Notifications page opens:

    Screenshot showing personal notification subscriptions in earlier versions of Azure DevOps.

Team administrators and recipients

As a team administrator, you can set up a notification subscription that's only for yourself. However, you can ensure that other team members receive specific notifications in the subscription. For each notification setting, you can identify the team recipients to receive the email.

Add custom notification subscription

Custom personal notification subscriptions let you identify precise criteria about events for which you want to receive notifications. You can use custom notification subscriptions to receive messages about any event that occurs in Azure DevOps.

Keep in mind that custom notification subscriptions aren't the same as default notification subscriptions. A default notification sends email only to users or groups directly associated with an event. Custom notifications enable you to define the set of message recipients.

  1. From your Notifications page, select New subscription:

    Screenshot that shows how to select the New subscription option in Azure DevOps.

    Screenshot that shows how to select the New subscription option in earlier versions of Azure DevOps.

  2. Select the Category and the Template type to use in the new subscription, and then select Next. For a list of supported templates, see Default and supported notifications.

    The following example shows a subscription to receive notifications when a pull request is created within a specific project:

    Screenshot that shows how to select the category and template type for a new notification subscription in Azure DevOps.

    Screenshot that shows how to select the category and template type for a new notification subscription in earlier versions of Azure DevOps.

  3. Configure your specific details for the new notification subscription:

    • Modify the description to help you identify the notification subscription later.
    • Provide the email address for delivery of the notifications. By default, your preferred contact email address is used.
    • Include zero or more fields to further specify the event criteria.

    Screenshot that shows how to configure the details for a new notification subscription, including the contact email address and other field criteria.

    Screenshot that shows how to configure the details for a new notification subscription, including the email address and other field criteria.

    Note

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

  4. Select Finish. The new notification subscription appears in the list under the category you selected:

    Screenshot that shows the new subscription in the list of personal notification subscriptions in Azure DevOps.

    Screenshot that shows the new subscription in the list of personal notification subscriptions in earlier versions of Azure DevOps.

Unsubscribe (opt out) from team or OOB notification subscription

You can unsubscribe or opt out of receiving notifications for specific team notification subscriptions, including out-of-the-box (OOB) subscriptions:

  1. Sign in to your organization (https://dev.azure.com/<organization>).

  2. Select User settings , and then select Notifications.

  3. In your list of Notification subscriptions, locate the notification you want to disable.

  4. To unsubscribe from the notification, move the State toggle to the Off position, which changes the toggle color from blue to gray.

The following example shows the user unsubscribed from the "Build completes" notification subscription:

Screenshot that shows how to unsubscribe from the Build completes notification subscription by moving the State toggle to the Off position.

Note

Whether you're an administrator or a regular team member, when you change the State value for a shared team notification subscription in your personal settings, the change affects only your personal notifications. The change doesn't affect the setting value of the same shared notification for other team members.

Disable work item notifications for project

To override organization settings and disable all work item notifications for a project in Azure DevOps, complete the following steps:

  1. Sign in to your project (https://dev.azure.com/<organization>/<project>).

  2. Select Project settings > Notifications.

  3. In the Notification list, select the work notification you want to disable, which highlights the row.

  4. Select User settings and then select Delivery settings.

  5. Select Do not deliver, and then select Save.