Configure filters

Your board's filter is an issue filter (a JQL query) that specifies which issues are included on your board. For example, your board may include issues from multiple projects, or from only one project, or from a particular component of a project.

Before you begin

To configure the board and any of its settings, you must be either:

  • project administrator for the location of the board

  • board administrator for the board itself

See Permissions overview for more information.

Jira Software allows you to create a classic Scrum or Kanban board that displays issues from multiple projects on your Jira site. But, next-gen project issues don't appear in classic project boards. When configuring a filter for your classic Scrum or Kanban board, you may still use a JQL filter that searches through next-gen projects, but you won't see or be able to transition those issues from your classic board.

Choosing a different filter for your board

1. Select Projects and select the relevant project.

2. Select more () in the top right corner > Board settings.

An expanded meatball menu on the board view of a Jira Software next-gen project. The board settings menu item is highlighted.

3. Halfway down the page, hover over the name of the filter displayed in the Saved Filter field > a pencil iconwill appear. Click it.

4. Choose a different filter for your board. Press the Enter key when finished.

Editing a board's filter

  1. Click Projects, then select the relevant project.

  2. Select more () in the top right corner > Board settings.

  3. In the General tab:

    • To change the filter's JQL query, click Edit Filter Query

    • To change the filter's name, description, or shares, click Edit Filter Shares

The board settings screen of a Scrum board in the General and filter tab

(Kanban only) Adding a sub-filter

If you are using a Kanban board, you can add a sub-filter that refines the issues returned by your board's filter. The sub-filter enables the Kanban board to show different data to the Reports.

The default sub-filter is:

 

This will result in issues released using the 'Release' button no longer appearing in the Active sprints (although the reports in Reports will continue to show them).

To add a sub-filter to your board:

  1. Go to your board, then select more () in the top right corner > Board settings.

  2. Edit the Kanban board sub-filter field and enter a JQL query. For information on JQL syntax, see JQL.

(Kanban only) Hiding completed issues

To improve your board's performance, all issues in the Done column which weren't updated within the last 2 weeks are hidden. You can change this time period, or choose to always show all issues.

To hide completed issues:

  1. Go to your board, then select more () in the top right corner > Board settings.

  2. In the Hide completed issues older than field, select the retention period. Issues that weren't updated within this period will be hidden.

Need help? If you can't find the answer you need in our documentation, we have other resources available to help you. See Getting help.

Last modified on Sep 20, 2020
Cached at 8:54 PM on Nov 25, 2020 |

Additional Help

Ask the Community