Search

Search Operators

You can use our search operators to refine your results on the Search page. By default, all queries will use `AND` when combining multiple operators. 

Below are a complete list of our search operators and their definitions:

Text

The following operators match text -- they can be single words that contain no spaces, or quoted strings that may contain spaces. 

  • epic:text

Search by Epic

  • label:text

Search by Label

  • project:text

Search by Project

  • state:text

Search by State.png

Number

The id: operator allows you to search for Stories by Story number.

  • id:number

Search by Story ID

Workflow State

In addition to the state: operator, which is text search on workflow state names, the following operators search over the different types of workflow states. Since stories can only have one workflow state, using more than one of these operators can yield no results.

  • is:unstarted

Search by Workflow State -- Unstarted

  • is:started

Search by Workflow State -- Started

  • is:done

Search by Workflow State -- Done

Usernames

Stories that have owners and/or requesters can be found by using either of the following operators (the argument must be a complete username in order to match): 

  • owner:username

Search by Owner

  • requester:username

Search by Requester

Story Types

A story can have one of three types: Feature, Bug, and Chore. A query that contains more than one unique type operator will yield no results.

  • type:feature|bug|chore

Search by Story Type -- Feature

Search by Story Type -- Bug

Search by Story Type -- Chore

Estimate

For Stories that use an Estimate scale, you can use the following operators. 

  • estimate:integer

Search for Estimated Points

  • is:unestimated - if there is no estimate set

Search for Unestimated Stories

Deadline

  • has:deadline - if a due date is set

Search by Deadline

  • is:overdue - if the due date is in the past

Search by Overdue

Relationships

These operators search for Stories that use our Story Relationship feature. 

  • is:blocked - if the story is blocked by another story

Search for Blocked Stories

  • is:blocker - if the story blocks another story

Search for Blocker Stories

Child Entities

If a story contains any of the following entities, using these operators will filter the results to include only those stories.

  • has:attachment - only searches for attached files, but not anything pasted or uploaded in comments. 

Search_for_Stories_with_Attachments.png

  • has:comment

Search for Stories with Comments

  • has:epic

Search for Stories with Epics

  • has:owner

Search for Stories with Owners

  • has:task

Search for Stories with Tasks

Archived

In general, archived stories will not rank high in the results.

  •  is:archived

Search for Archived Stories 

Inversions

Of note, you can search for the inverse of an operator by adding an ! or - in front of the operator. 

For example, i.e. !has:comment and -has:comment will return Stories with no comments.

Search for Stories without Comments 

 

Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.
Powered by Zendesk