Search

Searching in Clubhouse: Epic Search

You can use the Navigational Search Bar from any page in Clubhouse to find Epics using the search operators below. Epic search results can be found under the Epics tab in the Navigational Search menu, and are listed in order of relevance.

Epic search queries will look for matches in Epic titles, descriptions, and comments, and by default all queries will use `AND` logic when combining multiple operators (`OR` logic is not available in Search at this time, but it is available when filtering on the Stories page).

There are two categories of search operators available when using Navigational Search for Epics: Epic-specific search operators (which will find results only for Epics), and general search operators (which will find results for both Stories and Epics).

Epic-Specific Search Operators

has:story Finds all Epics containing Stories.
is:epic  Returns only Epics in the search results.

 

General Search Operators

ID Number
Project
Workflow State
Epic
Milestone
Label
Owner
Requester
Dates and Date Ranges
The `has:` Operators
The `is:` Operators

ID

Finds an Epic by its ID number.

id:799

 Search_for_Epic_by_Clubhouse_ID.png

Project

Finds Epics with Stories in a specific Project (may use the Project name or Project ID).

project:frontend

Search_for_Epic_by_Project_in_Clubhouse.png

Workflow State

Finds all Epics in a specific Epic workflow state. For best results, queries for multi-word workflow state titles should be placed in double quotes.

state:"ready for dev"

Search_for_Epics_by_State_in_Clubhouse.png

Epic

Finds an Epic by its title or ID, or finds all Epics containing a word or phrase. For best results, queries looking for an exact match should be placed in double quotes.

epic:"create more robot integrations"

Search_for_Epic_by_Title_in_Clubhouse.png

Note: While using the id: operator will find only the Epic with that ID (so it's great for quickly surfacing a specific Epic), the epic: operator will return both an Epic and the Stories it contains.

Find_Epics_and_Stories_Using_the_Epic_Operator.png     Find_Epics_and_Stories_Using_the_Epic_Operator_2.png

Milestone

Finds all Epics in a specific Milestone. For best results, queries for multi-word Milestone titles should be placed in double quotes.

Note: The milestone: operator will also find all Stories in the Epics within that Milestone.

milestone:q1-2019

Find_Epics_in_a_Milestone.png    Find_Stories_in_Epics_within_a_Milestone.png

Label

Finds all Epics with a specific Epic label. For best results, queries for multi-word labels should be placed in double quotes.

label:"user feedback"

Find_Epics_with_a_Label_in_Clubhouse.png

Note: At this time, Stories do not inherit Epic labels. In this example, there are five Stories returned by this search because there is a Story label also named 'user feedback.'

Owner

Finds all Epics owned by a user. This query requires the user's full mention name (also known as their @-name) to work. Do not include the @ symbol at the beginning of the mention name.

owner:rebeccahoffman

Search_by_Epic_Owner_in_Clubhouse.png

Requester

Finds all Epics requested by a user. This query requires the user's full mention name (also known as their @-name) to work. Do not include the @ symbol at the beginning of the mention name.

requester:rebeccahoffman

Find_Epics_by_Requester_in_Clubhouse.png

Dates and Date Ranges

Note: For more information about date-based operators (including examples of date-based searches), see our article Searching in Clubhouse: Dates and Date Ranges.

  • created: - Finds all Epics created on a certain date or within a date range.
  • updated: - Finds all Epics last updated on a certain date or within a date range.
  • started: - Finds all Epics started on a certain date or within a date range.
  • completed: - Finds all Epics completed on a certain date or within a date range.
  • due: Finds all Epics that are due on a certain date or within a date range.

The `has:` Operators

  • has:comment - Finds all Epics with comments.
  • has:deadline - Finds all Epics with a due date.
  • has:owner - Finds all Epics with an owner.

The `is:` Operators

  • is:unestimated - Finds all Epics with a point value of 0 (in other words, no Stories have point estimations in the Epic).
  • is:overdue - Finds all Epics with a due date in the past.
  • is:archived - Finds all archived Epics.
  • is: unstarted - Finds all Epics in an Unstarted workflow state.
  • is:started - Finds all Epics in a Started workflow state.
  • is:done - Finds all Epics in a Done workflow state.

Inversions and Exclusions

Of note, you can search for the inverse or exclude an operator by adding an ! or - in front of the operator. This is equivalent to a NOT boolean operator.

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

Searching_Epics_using_Inverses_in_Clubhouse.png

Have more questions? Submit a request
Powered by Zendesk