Configuring 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.

On this page:

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.

Choosing a different filter for your board

  1. Click your Jira icon ()

  2. Click Projects then select the relevant project
  3. Click the more icon (•••) at the top right > Board settings
  4. Halfway down the page, hover over the name of the filter displayed in the Saved Filter field > a pencil icon will appear. Click it
  5. Choose a different filter for your board. Press the Enter key when finished. 

Editing a board's filter

  1. Click your Jira icon ()

  2. Click Projects then select the relevant project
  3. Select more (•••) > Board settings
  4. 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

(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:

fixVersion in unreleasedVersions() OR fixVersion is EMPTY

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 (•••) > Board settings.

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



Next steps

 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 Jul 5, 2018

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.