About notifications

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

Notifications help you and your team stay informed about activity that occurs within your projects in Azure DevOps. You're notified when changes occur to the following items:

  • work items
  • code reviews
  • pull requests
  • source control files
  • builds

For example, you can get notified whenever you or your team resolves a bug or are assigned a work item.

You receive notifications based on rules or subscriptions. Subscriptions arise from the following instances:

  • Out-of-the-box (OOB) or default
  • Created by an administrator for a team or group that you belong to
  • Created by you

Notification types

There are four types of notifications that you can manage in Azure DevOps. See the following table of the notification types and required permission or role to manage.

Notification type Role required to manage
Personal notifications User
Team notifications Team Administrator or member of the Project Administrators group or Project Collection Administrators group
Project notifications Member of the Project Administrators group or Project Collection Administrators group
Global notifications Member of the Project Collection Administrators group

Personal notifications

You can manage your personal notifications in the following manner.

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

For more information, see Manage your personal notifications.

Team and project-level notifications

You can create a subscription for the following categories and select from the following templates.

Category Template options
Build
  • a build completes
  • a build fails
  • a legacy XAML build controller or agent's status changes
  • a legacy XAML build's quality changes
Code (Git)
  • a commit is pushed
  • a pull request is created or updated
  • a pull request my team is a reviewer on is updated
  • a comment is made on a pull request
Code (TFVC)
  • code is checked in
  • code is checked in with a policy override
  • a file with a specific extension is checked in
  • a file under a specific path is checked in
  • any code review changes
Pipelines
  • run stage waiting for approval
  • run stage waiting for Manual validation
Work
  • a work item is created
  • a work item is changed
  • a work item is deleted
  • a work item is restored
  • a work item is moved from this team project
Artifacts
  • a package is changed
Extension management
  • an extension is modified
Release
  • an approval for a deployment is pending
  • a deployment is completed
  • a request for release creation failed
  • a manual intervention for a deployment is pending

For more information, see Manage team, group, and global notifications.

Global notifications

Global notifications apply to all projects defined for an organization or collection.

Default subscription

The Default subscriptions tab lists all default global subscriptions available. The globe icon on a notification subscription indicates the subscription is a default subscription. View all default notification subscriptions.

Members of the Project Collection Administrators group have permission to enable/disable any default subscription in this view. Any member of the Project Collection Valid Users group has permission to view the details of the default subscription. The view and enable options are available in the context menu (...) associated with each individual subscription.

Screenshot of the organization-level notifications page: Default subscriptions tab.

Subscribers

The Subscribers section begins with an empty identity search box. Enter any group, team, or individual to view the list of subscriptions associated with the specified identity.

All notification subscriptions for the chosen identity are listed in this view. Management options are available from the context menu (...) associated with each subscription. The globe icon on subscription row indicates a default subscription.

Screenshot of organization-level notifications page: Subscribers list.

Statistics

The Statistics section shows the most active notification subscriptions and the top event initiators (group, team, or individual). The statistics are only for the current day and reset at 00:00 UTC. A benefit of these statistics is identifying unintended high volume subscriptions or event initiators.

Screenshot of organization-level notifications page, Statistics section.

Settings

Manage global-level Settings, such as delivery preferences.

The Settings section allows organization-level notification settings to be managed by any member of the Project Collection Administrators group. All teams and groups inherit the Default delivery option setting, which is why it isn't explicitly set at the team or group level.

Screenshot of organization-level notifications page: Settings.

For more information, see Manage team, group, and global notifications.

Permissions for notifications

There are no UI permissions associated with managing email notifications or alerts. Instead, they can be managed using the TFSSecurity command line tool.

  • By default, members of the project level Contributors group can subscribe to alerts for themselves.
  • Members of the Project Collection Administrators group, or users who have Edit collection-level information permission can set alerts in that collection for others or for a team.
  • Members of the Project Administrators group, or users who have Edit project-level information permissions can set alerts in that project for others or for a team.

Preferred email address

The preferred email address for your organization profile gets notifications, by default. It's typically the email address you signed into Azure DevOps with. You can manage this email address via your organization preferences profile page.

Note

Your preferred email address applies across all of your organizations and cannot be changed on a per-organization basis.

Integrating with other services

If your team uses an external service to collaborate—such as Campfire, Flowdock, or Slack—you can configure notifications to be sent to these services. These services are supported out of the box:

You can also use a third-party service like Zapier to send notifications to hundreds of other services. Learn more about Zapier and Azure DevOps Services integration.

On-premises SMTP server

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.