Help Center

ZenHub filters enable you to view only the work that you need so that you can focus on moving things forward. These powerful filters enable you to locate the exact Issues and data you need in seconds, so that you can focus on the work that matters most to you.


Course Outline

- Benefits of filtering
- How to filter the board
- Filter to see work assigned to me
- Logic to know about filters
- Accessing important filters at a later date

Filtering options on the Board

To get started with filtering, view a ZenHub Board. The filter options will appear just above the pipelines on the Board as seen below:



You will be able to filter by:

  • Labels
  • Milestones
  • Assignees
  • Epics
  • Releases
  • Estimates
  • Authors


Each set of filters can be used with either any or all filter logic:


Use Case Example

Example:Let's say you only want to view the Issues assigned to you with the label BUGthat are in a particular sprint. You can use the filtering options to view this data very quickly:



As you can see from above, this information was quickly displayed to us by taking the following steps:


1. Selecting the Assignees filter and choose yourself.

2. Selecting the Labels filter and choose BUG

3. Selecting the Milestones filter and select the desired milestone.

4. Ensuring you have Matching all filters selected from the filter type


Each of our filters work a bit differently, but here's common functionality regardless of the filter used:

  • None of the filters have an inherent and/all logic. Once more than 1 filter option is applied, a filter-wide option appears to switch between any/all.
    • At the moment, you cannot create groupings of filters to add multiple layers of and/all logic. For example, if you wanted to bundle  BugandCumulative Flow   or    Bugand Low Priority you'd have to do two separate queries.
  • The filters will only show options on the Board where there are Issues on the Board that match the criteria. For example, if you created a new Milestone or label, but no Issues have yet been assigned the new label or Milestone, there's no Issues that could be filtered by this selection. Therefore, this option will not yet appear on the filter choices. 
    • This behaviour is different than the sidebar options within an Issue, or our multi-select actions. Because these are actions, not filters, they will show your newly created label and Milestone, because they're within the list of available selections to apply to the Issue
  • On all filters except Authors and  Epics, you get an option to filter by  Issues with no _____. Use these to filter the Board by the inverse of the filter selected. For example, if you want to do Sprint hygiene, filter by Issues with no Estimate and pair this with your current Milestone. 



Logic to know about specific filters

Regardless of the filter, as a reminder, the filters will only show you options where:

  • The thing you're filtering for exists in the repo you have toggled on (for multi-repo Boards)
  • The filter selection you're looking for has Issues that match that criteria open on the Board. If you just created something, but it's never been assigned to an Issue, it won't appear as it's not active as a potential view yet.


The Milestone filter

  • Milestones will appear as a filter option only when they:
    • Are open. 
      • Closed Milestones will not appear. You can filter the Board by a previously closed Milestone by navigating via GitHub to the repo's Milestone page, going to closed Milestones, clicking into the Milestone itself and use the See this milestone on the Board option. NOTE: This will only pull Issues that are still open, or are within the last 50 closed Issues on the Board (irrespective of the filter applied).  

    • Have Issues assigned to the Milestone that are open or within the last 50 closed Issues on the Board. They do not need to be estimated, but do need to appear on the Board
    • Have the respective repos filter option toggled on for the Issues you're trying to filter. If for example a Milestone exists in one of the repos toggled off and has assigned Issues, it will not appear as it doesn't 'exist' within the repositories still toggled on. 


The Label filter

  • Labels will appear as a filter option only when they:
    • Have Issues assigned to the label that are open or within the last 50 closed Issues on the Board.
    • Have the respective repos filter option toggled on for the Issues you're trying to filter. If for example a label exists in one of the repos toggled off, but is assigned to an Issue, it will not appear as it doesn't 'exist' within the repositories still toggled on. 


The Author filter

  • This filter will only show you the authors of Issues that are on the Board. This will not show all available authors. If you have 100 team members, but only 30 create Issues, you will not see the extra 70 in the filters. It will only show you individuals who have created Issues open on the Board.


The Epic filter

  • When filtering by a specific Epic, it will also pull into view any nested Epics and that Epics Issues. If you want to see only the highest level of the Epic, and not it's nested Epics / child Issues you can combine your original Epic selection with an additional Not: selection, adding a Not: filter per-nested Epic

Keeping track of important filters

We keep track of all the filters that you've applied within the boards URL. This means that you can bookmark a filtered view of the board in your browser, and navigate back to that bookmark at anytime. This is a great way for you to quickly and easily generate a view of the Board containing the information that matters most to you!


You're all set! You can now filter the board to view the information that matters to you in seconds!


For more information, see : Get to know board features and functionality


Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.