Triage work items with a work item query in Azure Boards and Azure DevOps

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019 | TFS 2018

Visual Studio 2019 | Visual Studio 2015 | Visual Studio 2013

Using a work item query you can quickly review and update work items. Teams often use the triage mode for a query to complete 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.
  • 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 Stakeholder access quick reference.

  • 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.
  • 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 Queries, the page opens to Favorites. This page lists those queries that you have indicated are a favorite. 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 chosen as favorites show up on the Favorites page. Favorite queries 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.

From your web browser, open Boards>Queries

Use triage buttons and save work items

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.

Screenshot of  Web portal, Queries Results page, move up or down in the list controls.

You can save each work item as you change it. Or, you can update multiple work items and save them all at once with Save Items.

Screenshot of Web portal, Queries Results, and Save Items.

If you don't see Save Items, choose the More commands and select the Save Items option.

Screenshot of Query results page, save bulk modified items.

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.

Screenshot of Triage query results, TFS 2018 version.

You can save each work item as you change it. Or, you can update multiple work items and save them all at once with Save Items.

Bulk update and save changes to work items

From the web portal, 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 More commands, and then select the option you want from the menu of options.

Screenshot of Web portal, Query results multi-select menu.

Work items shown in bold text indicate that local changes haven't yet been saved to the data store.

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

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

Screenshot of Web portal, Query results page, save bulk modified items, TFS 2018 version.