| title | titleSuffix | description | ms.custom | ms.subservice | ms.author | author | ms.topic | monikerRange | ms.date |
|---|---|---|---|---|---|---|---|---|---|
Filter lists, boards, and directories |
Azure DevOps |
Filter your view to focus on items of interest |
navigation, cross-service |
azure-devops-projects |
chcomley |
chcomley |
how-to |
<= azure-devops |
04/04/2022 |
[!INCLUDE version-lt-eq-azure-devops]
Several applications and pages support filtering, which is very useful when a large number of artifacts or items have been defined. Most directory views provide one or more filter functions.
You can filter most items using keywords or a user name for an author of an item or where work is assigned to them. You can filter lists and boards in the following areas:
::: moniker range=">= azure-devops-2019"
- Git repositories: Branches, Commits, Commit history, Pull Requests, Pushes, and Repositories
- Work tracking: Work Items, Boards, Backlogs, Sprint Backlogs, and Taskboards
- Directories: Dashboards, Boards, Backlogs, Sprints, Queries, Builds, Releases
::: moniker-end
Note
You may have fewer or additional filter options based on the features you've enabled or the platform and version that you are working from.
To turn filtering on, choose the :::image type="icon" source="../../media/icons/filter-icon.png" border="false"::: filter icon.
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.
The filtered set is always a flat list, even if you've selected to show parents.
The filter criteria ignores the following characters: , (comma), . (period), / (forward slash), and \ (back slash).
::: moniker range=">= azure-devops-2019"
Choose the :::image type="icon" source="../../media/icons/filter-icon.png" border="false"::: filter icon to filter a directory list by keyword, team, or other supported field. Keywords apply to titles, descriptions, and team names.
For example, here we turn filtering on for the dashboard directory.
[!div class="mx-imgBorder"]
::: moniker-end