Skip to content

Latest commit

 

History

History
165 lines (94 loc) · 8.08 KB

manage-your-personal-notifications.md

File metadata and controls

165 lines (94 loc) · 8.08 KB
title titleSuffix description ms.subservice ms.assetid ms.custom ms.topic ms.author author ms.date monikerRange
Manage personal notification settings
Azure DevOps
Get personally notified, when changes occur to source code, git, work items, and builds in Azure DevOps.
azure-devops-notifications
644687b3-e30e-46b0-8d3e-3d4a4e34d13a
cross-project
how-to
chcomley
chcomley
06/22/2023
<= azure-devops

Manage your personal notifications

[!INCLUDE version-lt-eq-azure-devops]

You can manage your personal notifications in the following ways:

  • 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

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.

[!INCLUDE note-smtp-server]

Prerequisites

Every user can manage their personal notifications.

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

::: moniker range="azure-devops"

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

  2. Select :::image type="icon" source="../../media/icons/user-settings-gear.png" border="false"::: User settings, and then select Notifications from the resulting list.

    :::image type="content" source="media/personal-notifications-preview.png" alt-text="Preview page of personal notifications.":::

::: moniker-end

::: moniker range="< azure-devops"

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

  2. Open User settings, and then select Notification settings from the resulting list.

    :::image type="content" source="media/nav-personal-notifications-hub-newnav.png" alt-text="Screenshot showing personal notifications hub.":::

::: moniker-end

::: moniker range="azure-devops"

:::image type="content" source="media/unsubscribe-personal-notifications-preview.png" alt-text="Screenshot showing personal notification subscriptions.":::

::: moniker-end

::: moniker range=" < azure-devops"

:::image type="content" source="media/unsubscribe-personal-notifications.png" alt-text="Screenshot of unsubscribe from notification subscriptions.":::

::: moniker-end

::: moniker range="<=azure-devops"

A notification subscription can be only for you. But, if you're a team administrator you can ensure that it goes to everyone on the team.

::: moniker-end

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.

::: moniker range=" azure-devops"

  1. From your Notifications page, select New subscription.

:::image type="content" source="media/manage-personal-notifications-new-subscription-preview.png" alt-text="Screenshot of New notification subscription selected.":::

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

    :::image type="content" source="media/manage-personal-notifications-new-subscription-dialog-preview.png" alt-text="Screenshot of new notification subscription-selected category and template.":::

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

    :::image type="content" source="media/manage-personal-notifications-complete-pull-request-subscription-preview.png" alt-text="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.

    :::image type="content" source="media/manage-personal-notifications-subscription-added-preview.png" alt-text="Screenshot of confirmation of new subscription added.":::

::: moniker-end

::: moniker range="<azure-devops"

  1. From your Notifications page, select New subscription.

    :::image type="content" source="media/manage-personal-notifications-new-subscription-newnav.png" alt-text="Screenshot of the personal new notification subscription dialog, current page.":::

  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.

    :::image type="content" source="media/manage-personal-notifications-new-subscription-dialog.png" alt-text="Screenshot of personal notifications new notification subscription dialog.":::

  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.

    :::image type="content" source="media/manage-personal-notifications-complete-pull-request-subscription.png" alt-text="Screenshot of new notification subscription event 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.

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

    :::image type="content" source="media/manage-personal-notifications-subscription-added.png" alt-text="Screenshot showing the notification subscription on the list under its category.":::

::: moniker-end

[!INCLUDE opt-out-notification]

Next steps

[!div class="nextstepaction"] Use @ mentions in work items and pull requests

Related articles

Limitations

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