Functional work item search

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

Functional work item search command filters let you search for work items more precisely by assignment, work item type, specific fields, and more. For more filter functions, see Get started with search.

Work Item Search lets you do the following tasks and more.

Search task	Description
Search over all your projects	Search in your own and your partner teams' backlog. To search across your entire enterprise's work items, use cross-project searches. Narrow your search by using project and area path filters.
Search across all work item fields	Quickly and easily find relevant work items by searching across all work item fields, including custom fields. Use a full text search across all fields to efficiently locate relevant work items. The snippet view indicates where matches were found.
Search in specific fields	Use the quick in-line search filters to narrow down to a list of work items in seconds. Use the filters on any work item field. The list of suggestions helps complete your search faster. For example, a search such as AssignedTo:Chris WorkItemType:Bug State:Active finds all active bugs assigned to a user named Chris.
Search across test	Search across Test Plans, Test Suites, and other test work item types.
Take advantage of integration with work item tracking	The Work Item Search interface integrates with familiar controls for managing your work items; letting you view, edit, comment, share, and more.

Prerequisites

• Access levels:
  • All project members: Every project member can use the search functions, including users with Stakeholder, Basic, and higher levels of access.

• Work Item Search is available by default when the Boards service is installed and enabled.

Search by work item ID

Enter the work item ID in the Azure DevOps title bar. You can read and edit the work item in a modal dialog.

Search across all fields

Search all work item fields, including custom ones, for natural searches. The following snippet view shows matches.

• Use simple search strings for words or phrases. Work item search matches derived forms of your search terms; for example, a search for "updating" also finds instances of the word "updated" and "update." Searches aren't case-sensitive.
• Search from a project to, by default, search only within that project.
• Search from inside a team to, by default, search only within the default area path of that team.
  • Select a project to view a list of area paths in that project for which you have Read access.
  • Select area paths in the tree to narrow your search if necessary.
• View hit counts for all projects, even one that you don't select.
• Open the search results in a new browser tab from either the main search function or by selecting Ctrl + Shift + Enter.

Best practices

• Text search across all fields: Use a text search across all fields to efficiently locate relevant work items. This search is useful for finding work items with similar exception traces.
• Quick in-line search filters: Use quick in-line search filters on any work item field to narrow down the list of work items in seconds. The list of suggestions helps you complete your search faster.

Compare search vs. managed work item queries

The main search function and managed queries are two ways to find and list work items. For a single work item, use the main search. For a list of work items that you want to triage, update, chart, or share, use a managed query.

You can search more fields with the main search function than with managed queries.

---

Use a managed query

Search

---

• List items to perform bulk updates to fields.
• Review work that's in progress or recently closed.
• Triage work: set priority, review, update.
• Create a chart and add it to a dashboard.
• Create a chart to get a count of items or sum a field.
• Create a chart that shows a burndown or burnup over time.
• View a tree of parent-child related work items.
• List work items with link relationships.
• List work items for a single project, multiple projects, or across all projects.

• Find a specific work item using its ID or a keyword.
• Find one or more work items across all projects in a fast, flexible manner.
• Perform full text search across all work item fields.
• Review work items assigned to a specific team member.
• Search against specific work item fields to quickly narrow down a list of work items.
• Determine what key words support a managed search.
• List work items for a single project, multiple projects, or across all projects.

---

For more information, see the following articles:

• View and run a query
• Use search
• Define a query
• Query quick reference, Example queries

Fine-tune your search

1. To fine-tune your search, specify fields. Search all assigned items by entering a: and a user name.

   

   Quick filters:

   • a: for Assigned to:
   • c: for Created by:
   • s: for State
   • t: for Work item type

2. Start entering the name of a field in your work items; for example, enter ta.

   

   The dropdown list shows work item field name suggestions that match user input. These suggestions help you complete the search faster. For example, a search such as tags:Critical finds all work items tagged 'Critical.'

3. Add more filters to further narrow your search, and use Boolean operators to combine terms if necessary. For example, a: Chris t: Bug s: Active finds all active bugs assigned to a user named Chris.

4. Narrow your search to specific types and states, by using the selector lists at the top of the results page.

5. Widen your search across all projects, or narrow it to specific types and states. Use the filter to show the selector lists.

   

6. Select the criteria you want in the drop-down selector lists, or search across the entire organization.

   

7. Sort the results with the drop-down list of field names, work item types, or by relevance.

   

Quick filters for matching in specific fields

Quick inline search filters let you refine work items in seconds. The dropdown list of suggestions helps complete your search faster. Mix and match the functions to create quick powerful searches.

Usage	Example
Scope your search terms to match in any work item field, including custom fields. Enter the field name followed by the search terms.	tags:Critical finds work items with a 'tags' field containing the term 'Critical.'
Use multiple inline search filters to scope your search by any work item field, including custom fields.	t: Bug path:"project\search" finds all bugs in the area path "project\search."
Use the operators >, >=, <, <=, =, and != for date, integer, and float fields.	t: Bug CreatedDate> @Today-7 finds all bugs created in the last week.
For search queries containing multiple terms, use quotes to group the terms. However, quotes don't yield exact matches as you might expect; results match any work items containing the grouped terms in any order.	BuildPath: "tools.demoproject.com" finds work items that contain the path "tools.demoproject.com."

Scope projects and area and iteration paths using filters

Filters make it easy to narrow the search to specified projects and area paths.

Narrow the search to a specific location using the proj, area, iteration, path, and comment filters:

Usage	Example
Finds all occurrences of the word Wiki in the Fabrikam project.	Wiki proj:Fabrikam
Finds all occurrences of the word Wiki in the area path Contoso/Mobile and its subpaths.	Wiki area:Contoso/Mobile
Finds all occurrences of the word Wiki in the iteration path Contoso/Sprint101 and its subpaths.	Wiki iteration:Contoso/Sprint101
Enclose the argument to the filter in double-quotes if it contains a space.	Wiki path:"Contoso/Windows Phones and Devices/Services"
Finds backlog comments	comment:todo

See more of the work item

You can quickly get a full screen view of the selected work item using expand and shrink in the toolbar. However, another way to see more of the work item, while you can still select work items from the list of matching results, is to hide the left column filter pane by choosing < at the top left of the column. Use > to restore the filter pane.

If you're using a portrait orientation screen, use the Preview pane: Right link at the top right of the window to display the code below the search results list.

Tip

Search remembers the state of the filter pane, configuration of the work item view pane, and its position between sessions as part of your user preferences.

Search work items with REST API

You can use APIs to extend or supplement the capabilities listed in this article. For information about Work Item Search with REST API, see Fetch Work Item Search Results.

Next steps

Supported filter functions and more for work items

Related articles

• Get started with Search
• Search code
• Search artifacts and packages