Filter backlogs or queries based on keywords, tags, or other fields

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

If you have many items listed in your product or portfolio backlog—and you want to focus on a subset of them—you can filter the set.

Filter based on keywords or fields

You can filter work items by typing a keyword or using one or more of the fields provided, such as work item type, assigned to, state, and tags. Based on the keyword that you enter, the filter function will list work items based on any visible/displayed column or field, including tags. Also, you can enter a value for an ID, whether or not the ID field is visible.

To show the filter toolbar, choose the  filter icon, or enter the Ctrl+Shift+f keyboard shortcut. You can filter all backlogs, boards, and query results.

Filter by keyword

Choose one or more values from the multi-select drop-down menu for each field. The values for these fields are populated as follows:

  • Assigned To: All users who are currently assigned to work items on the board plus Unassigned
  • Iteration: All Iteration Paths selected for the current team and for which there are work items assigned to that iteration
  • Work item type: Work item types defined for the Requirements Category (product backlog) or Features or Epic categories (feature or epic portfolio backlogs), subject to work items being assigned to the work item types
  • Tags: All tags assigned to work items on the board
  • Parent Work Items: All features defined for the team, or all epics defined for the team when viewing the Features board (The Parent Work Items field doesn't appear when viewing the Epic or top-level Kanban board)

Note

Filter options are dependent on the work items that meet the filter criteria. For example, if you don't have any work items assigned to Sprint 4, then the Sprint 4 option won't appear in the filter options for the Iteration Path.

Here we show a filtered backlog based on the keyword "issues". Filtered pages show the  filtered icon. The filtered set is always a flat list, even if you've selected to show a hierarchical backlog view.

Filter by keyword

To clear and dismiss filtering, choose the  close filter icon.

Filter based on keywords or fields

You can filter work items by typing a keyword or using one or more of the fields provided, such as work item type, assigned to, state, and tags. Based on the keyword that you enter, the filter function will list work items based on any visible/displayed column or field, including tags. Also, you can enter a value for an ID, whether or not the ID field is visible.

To show the filter toolbar, choose the  filter icon, or enter the Ctrl+Shift+f keyboard shortcut. You can filter all backlogs, boards, and query results.

Backlogs, turn filtering on

The filtered set is always a flat list, even if you've selected to show parents.

Filter based on keywords

You can use keywords to filter your backlogs or queries. The filter function lists those work items based on any visible/displayed column or field, including tags, based on the keyword that you enter. Also, you can enter a value for an ID, whether or not the ID field is visible.

Here, we filter the backlog to only show items that include 'Web' in any one of the displayed column fields.

Apply text filter

The filtered set is always a flat list, even if you've selected to show parents.

Filter based on tags

If you've added tags to your work items, you can filter your backlogs, Kanban boards, and query results using the tag filter icon tag filter. For backlogs and query results, add Tags as a column option prior to filtering on tags.

To learn more about filtering using tags, see Add tags to work items to categorize and filter lists and boards, Filter lists using tags.

Characters ignored by keyword filter criteria

The filter criteria ignores the following characters: , (comma), . (period), / (forward slash), and \ (back slash).

The filter criteria ignores the following characters when the field value starts with the character: {, (, [, !, @, #, $, %, ^, &, *, ~, `, ', ".