Triage work items

Azure Boards | Azure DevOps Server 2019 | TFS 2018 | TFS 2017 | TFS 2015 | TFS 2013

Using a work item query you can quickly review and update work items. Oftentimes team use the triage mode for a query to perform the following tasks:

  • Set the priority of a bug or work item
  • Assign a work item to a sprint or team member
  • Add details to the description, acceptance criteria, or repo steps
  • Link related work items
  • Update the status of work items

In this article you'll learn how to:

  • Use triage query mode to update a list of work items
  • Bulk save work items that you've updated

Prerequisites

By default, all project members and users with Stakeholder access can view and run all shared queries. You can change the permissions set for a shared query folder or shared query. For details, see Set query permissions.

  • You must connect to a project. If you don't have a project yet, create one.
  • To view, run, or email a query, you must be granted Stakeholder access or higher. For details, see About access levels.
  • To add and save a query under Shared queries, you must be granted Basic access or higher. Also, you must have your Contribute permission set to Allow for the folder you want to add the query to. By default, the Contributors group doesn't have this permission.

Note

Users with Stakeholder access for a public project have full access to query features just like users with Basic access. For details, see About access levels.

  • You must connect to a project. If you don't have a project yet, create one.
  • To view, run, or email a query, you must be granted Stakeholder access or higher. For details, see .
  • To add and save a query under Shared queries, you must be granted Basic access or higher. Also, you must have your Contribute permission set to Allow for the folder you want to add the query to. By default, the Contributors group doesn't have this permission.

Open Queries

From your web browser, (1) check that you have selected the right project, (2) choose Boards>Queries, and then (3) choose All.

Open Boards>Queries, vertical nav

If it is your first time opening Work, the page opens to Favorites which lists all queries you have favorited. Otherwise, you can choose All to view all queries you've defined and shared queries defined for the project.

Tip

Queries you or your team have favorited show up on the Favorites page. Queries you have favorited along with other objects also appear on your Project page. To learn more, see Set personal or team favorites.

From your web browser, open Boards>Queries.

Web portal, choose Boards>Queries

The buttons to move up or down within the query results list are outside the work item form. Choose Bottom to cycle through the choices for where the work item form appears: Bottom, Right, or Off.

Web portal, choose Boards>Queries

The buttons to move up or down within the query results list are inside the work item form. Choose Bottom to cycle through the choices for where the work item form appears: Bottom, Right, or Off.

Triage query results

Tip

The same buttons to move up or down within a work item list are available from a Work Items page when you choose a work item. See

Bulk update and save changes to work items

You can update several work items through the triage process, and then do a bulk save when you're finished.

Multi-select the work items you want to update, choose the  actions icon, and then select the option you want from the menu of options.

Query results multi-select menu

Multi-select the work items you want to update, choose the  context icon, and then select the option you want from the menu of options.

Query results multi-select menu, TFS-2017

Multi-select the work items you want to update, choose the  context icon, and then select the option you want from the menu of options.

Query results multi-select menu, TFS 2015

Work items shown in bold text indicate that local changes have not yet been saved to the data store.

Choose Save items to save all work items you've modified.

Choose Save work items to save all modified work items

Choose the double-save-icon double-save icon to save all work items you've modified.

Azure Boards and TFS 2017, Query results page, save bulk modified items