What Are Saved Queries?
Saved queries let you define a reusable set of filters and column configurations for viewing work items. Once saved, a query appears in the project sidebar so any team member can open it with one click.
Queries are useful for recurring views like "all high-priority bugs in progress", "my assigned items this sprint", or "everything blocked and waiting for review".
Creating a Query
- Navigate to Queries in the project sidebar and click New Query.
- Use the visual query builder to add filter conditions, or switch to code mode to write WIQL directly.
- Configure which columns to display in the results table.
- Click Save and give the query a name.
The Visual Query Builder
The visual builder lets you add conditions without writing any syntax. Each condition consists of:
- A field (e.g., Status, Priority, Type, Assignee)
- An operator (e.g., equals, not equals, contains, is empty)
- A value (typed in or selected from a list)
Multiple conditions are joined with AND (all conditions must match) or OR (any condition must match).
WIQL — Work Item Query Language
For more control, switch to code mode and write a WIQL expression. WIQL uses a SQL-like syntax to filter work items.
Basic structure
<field> <operator> <value>
Combining conditions
<condition> AND <condition>
<condition> OR <condition>
Examples
Filter by a single field:
status = "In Progress"
Combine multiple conditions:
status = "In Progress" AND priority = "high"
Filter by type and exclude a specific status:
type = "bug" AND status != "Done"
Match one of several values:
priority IN ("high", "urgent")
Filter items assigned to the current user:
assignee = @me
Filter by parent item:
parentId = "epic-123" AND type = "story"
You can switch between visual mode and code mode at any time. The visual builder and WIQL stay in sync — changes in one are reflected in the other.
Column Configuration
Each saved query has its own column configuration. You can choose which fields to show as columns in the results table and reorder them by dragging.
Available columns include all standard fields (number, title, type, status, priority, assignee) as well as any custom metadata fields configured for the project.
To configure columns, open the query settings and go to the Columns tab. Add or remove columns and drag them into the order you want.
Duplicating and Managing Queries
Right-click a query in the sidebar (or use the action menu) to duplicate, rename, or delete it. Duplicating a query is useful when you want to create a variation of an existing query without starting from scratch.