Follow a user story, bug, issue, or other work item or pull request

Azure Boards | Azure Repos | Azure DevOps Server 2019 | TFS 2018 | TFS 2017

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.

Follow a work item

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

Work item form, Follow icon control

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.

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 user profile

To stop following changes, choose the  following icon.

Follow a pull request

To track the progress of a single pull request, choose the  actions icon for the pull request, and select the  Follow option. 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 user profile.

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

Manage work items that you're following

You can review and manage all the work items you've selected to follow.

Note

Your web portal uses either the New navigation or Previous navigation user interface. Choose the New navigation tab if the New Navigation feature is enabled. You'll see a vertical sidebar along with other navigational features when New Navigation has been enabled for the signed-in user or the organization. Choose Previous navigation when you see a top-level, blue-bar—indicating that New navigation isn't enabled. For more information, see Web portal navigation.

Note

Choose the New navigation tab for guidance. Azure DevOps Server 2019 supports the New Navigation user interface. For more information, see Web portal navigation.

Note

Choose the Previous navigation tab for guidance. TFS 2018 and earlier versions only support the previous navigation user interface. For more information, see Web portal navigation.

Open Boards>Queries, choose All, and under My Queries, choose Followed work items.

Boards>Queries>All>Followed work items, new nav

From this view, you can view all items you're following across all projects. 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.

You can also view and manage work that you're following from Boards>Work Items and pivot to Following.

Boards>Queries>All>Followed work items, new nav

New navigation isn't supported for TFS 2018 and earlier versions. Choose the Previous navigation tab for guidance.

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.