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:

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.

Screen_Shot_2018-02-08_at_4.30.28_PM.png 

Text

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

  • epic:text

Screen_Shot_2018-02-08_at_3.57.24_PM.png

  • label:text

Screen_Shot_2018-02-08_at_4.11.02_PM.png

  • project:text

Screen_Shot_2018-02-08_at_4.12.49_PM.png

  • state:text

Screen_Shot_2018-02-08_at_4.24.26_PM.png

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

Screen_Shot_2018-02-08_at_5.04.10_PM.png

  • is:started

Screen_Shot_2018-02-08_at_5.05.44_PM.png

  • is:done

Screen_Shot_2018-02-08_at_5.06.56_PM.png

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

Screen_Shot_2018-02-08_at_5.14.18_PM.png

  • requester:username

Screen_Shot_2018-02-08_at_5.23.15_PM.png

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

Screen_Shot_2018-02-08_at_5.45.09_PM.png

Screen_Shot_2018-02-08_at_5.45.24_PM.png

Screen_Shot_2018-02-08_at_5.46.00_PM.png

Estimate

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

  • estimate:integer

Screen_Shot_2018-02-08_at_5.53.08_PM.png

  • is:unestimated - if there is no estimate set

Screen_Shot_2018-02-08_at_5.57.06_PM.png

Deadline

  • has:deadline - if a due date is set

Screen_Shot_2018-02-08_at_6.04.11_PM.png

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

Screen_Shot_2018-02-08_at_6.05.21_PM.png

Relationships

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

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

Screen_Shot_2018-02-09_at_11.49.06_AM.png

  • is:blocker - if the story blocks another story

Screen_Shot_2018-02-09_at_11.49.23_AM.png

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. 
  • has:comment

Screen_Shot_2018-02-08_at_4.33.00_PM.png

  • has:epic

Screen_Shot_2018-02-09_at_10.57.47_PM.png

  • has:owner

Screen_Shot_2018-02-09_at_10.56.30_PM.png

  • has:task

Screen_Shot_2018-02-09_at_10.59.17_PM.png

Archived

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

  •  is:archived

Screen_Shot_2018-02-09_at_10.55.02_PM.png 

 

Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.
Powered by Zendesk