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
Finds an Epic by its ID number.
Finds Epics with Stories in a specific Project (may use the Project name or Project ID).
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"
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"
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.
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.
Finds all Epics with a specific Epic label. For best results, queries for multi-word labels should be placed in double quotes.
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.'
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.
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.
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 will return Epics with no comments.