Manage your personal notifications

Prerequisites

• Every user can manage their personal notifications
• See about notifications

View your personal notifications

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

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.

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.

   

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

   

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.

   

   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.

   

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

   

   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.

   

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

   

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.

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

   

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.

   

   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.

   

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.

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.