Follow a work item or pull request

VSTS | TFS 2018 | TFS 2017

Note

The Follow a work item feature is available from TFS 2017 and later versions. The Follow a pull request feature is available from TFS 2017.1 and later versions. To update your on-premises TFS, visit the Visual Studio downloads page for Team Foundation Server.

To get notified of changes made to a work item or a pull request, you can elect to follow them.

This topic shows you how to:

  • Follow a work item
  • Follow a pull request
  • Manage work items that you're following

You must configure an SMTP sever in order for team members to receive notifications.

Note

The Follow a pull request feature is available from TFS 2017.1 and later versions. To update your on-premises TFS, visit the Visual Studio downloads page for Team Foundation Server.

Follow a work item

When you want to track the progress of a single work item, click the Follow icon icon. This signals the system to notify you when changes are made to the work item.

VSTS Work item form, Follow icon control

You'll only receive notifications when other members of your team modifies the work item, such as adding to the discussion, changing a field value, or adding an attachment.

Notifications are sent to your preferred email address, which you can change from your account preferences

To stop following changes, click the Following icon icon.

Follow a pull request

To track the progress of a single pull request, click the Follow icon option from the context menu. This signals the system to notify you when changes are made to the PR.

Pull Request, context menu, Follow icon option

You'll only receive notifications when other members of your team modifies the PR, such as adding to the discussion or adding an attachment.

Notifications are sent to your preferred email address, which you can change from your account preferences.

To stop following changes, open the PR context menu and click the Following icon icon.

Manage work items that you're following

You can review and manage all the work items you've selected to follow from the Followed work items page. You access this page from the Work>Queries page.

Followed work items, Follow icon control

From this view, you can view all items you're following across all team projects within the account. Also, you can perform similar actions supported with a query results view, such as:

  • Refresh the view
  • Add or remove visible columns
  • Sort the order of specific columns
  • Filter results by text or tags
  • Set work item pane
  • Enter full screen mode.

However, this view isn't based on a query so you can't modify the parameters of the view.

You can also view and manage work that you're following from your home pages. To learn more, see Work effectively from your account hub.

::: moniker range="vsts"

Account home, Work, Following page

Account home, Work, Assigned to me page

Â

Q: Can I add someone else to follow a work item or PR?

A: You can't add another team member to follow a work item or pull request at this time. You can subscribe them to get notified based on select criteria, such as when a work item is create or modified, or a pull request is created. For details, see Manage team notifications.

::: moniker-end