Documentation for GreenHopper 6.2.x. Documentation for earlier versions of GreenHopper is [available too].

Configuring Filters

Created by Rosie Jameson [Atlassian], last updated on May 15, 2013 2 minute read

Your board's filter is a JIRA 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.

Note that only the owner of a board (or a person with the 'JIRA Administrators' global permission) can configure a board's filter.

Choosing a different Filter for your Board

To choose which filter is associated with your board:

Select Agile > Manage Boards from the top navigation bar, then click the Configure link corresponding to the board of interest.
Click the Filter tab.
Click the 'pencil' icon (which will appear when you hover over the name of the Saved Filter) to choose a different filter for your board. Press the 'Enter' key when finished.

On this page:

Related pages:

Configuring a Board

Screenshot 1: the 'Board Configuration' screen — 'Filter' tab (click to enlarge).

Editing a Board's Filter

To edit the filter which is currently associated with your board:

Select Agile > Manage Boards from the top navigation bar, then click the Configure link corresponding to the board of interest.
Click the Filter tab.
- To change the filter's JQL query, click View in Issue Navigator. For more details, see the JIRA documentation on JQL.
- To change the filter's name, description, or shares, click Edit Filter. For more details, see the JIRA documentation on issue filters.

Adding a Sub-Filter for Work mode

A sub-filter refines the issues returned by your board's filter. The sub-filter applies to Work mode only. The sub-filter enables the Report mode to show different data to Work mode.

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 Work mode (although the reports in Report mode will continue to show them).

The Work sub-filter is only available for Kanban boards.

To add a sub-filter to your board:

Select Agile > Manage Boards from the top navigation bar, then click the Configure link corresponding to the board of interest.
Click the Filter tab.
Hover over the words 'Add Sub-Filter' and click the pencil icon that appears. Enter a JQL query.
For more details, see the JIRA documentation on JQL.

No labels

12 Comments

Joe
Oct 10, 2012
When I edit my filter to include other projects, I see them in the issue navigator, but my board doesn't change to reflect the additional project's issues.
Anonymous
Oct 10, 2012
Joe +1
Anonymous
Oct 19, 2012
I'm having the same experience as the above posters. Any insight?
Joe
Oct 19, 2012
In my case it turned out to be that the issue statuses of the other projects were not compatible with the board I was adding them to. The two possible solution are:
(1) The easy thing is to edit the board column configuration to include the additional statuses in the columns
(2) Rethink the workflow scheme in a way that is consistent across projects. This is more work, but a better long-term solution IMO.
1. Nicholas Muldoon [Atlassian]
  Nov 21, 2012
  Joe, spot on. Thanks for sharing the solution you found.
  Regards,
  Nicholas Muldoon
  @GreenHopperTeam
Mikael Glentoft
Nov 26, 2012
When I click the filter tab I see a filter that doesn't correspond to the issues in the sprint.
The filter is: project = Lennart ORDER BY Rank ASC
This would match every issue in the entire project, but the burndown chart is based only on the issues in the sprint so it seems to work.
Is this functionality broken or have I missed something?

I'm using JIRA version 5.1.7 with greenhopper plugin version 6.0.8.

Regards,
Mikael
1. Rosie Jameson [Atlassian]
  Nov 28, 2012
  You are right Mikael, the board shows all (unfinished) sprints, but the Burndown Chart is sprint-specific. (Have I understood your question correctly?)
  Regards,
  Rosie
Jake Holman
Mar 26, 2013
Under "Editing a Board's Filter" it states in step 3
> Click Edit Filter. This will take you to the JIRA 'Edit Current Filter' screen, where you can change the filter's name, description, shares, and JQL query.
This is untrue, as the JQL query is simply not there. There is nothing else on that page other than being able to change the name, description and shares.
These instructions are out of date.
1. Rosie Jameson [Atlassian]
  Mar 26, 2013
  Thank you – to edit the JQL query, you actually need to click View in Issue Navigator. I have updated the instructions.
Tim Daniell
Apr 03, 2013
There seems to be hidden criteria which is added to my filter on my Sprint board. I have defined a list of status I do not want to appear when I am in planning mode such as "Awaiting Testing" etc, but if I completely remove my filter I still do not see "Closed" JIRA's and also JIRAs with a "Review" status. I want JIRAs with a "Review" status to appear in planning mode but I can't see then, even if I completely remove the filter entirely. Is there a hidden filter and if so, how can I edit it?
1. Rosie Jameson [Atlassian]
  Apr 07, 2013
  I am not quite sure what is happening here. Can you please contact http://support.atlassian.com ? Thank you
Peter Hendrix
Aug 13, 2013
My internal JIRA account is configured as system administrator AND I am the owner of the board, however I am missing the 'edit filter' link on my board configuration page... what could be wrong?
We use the 'domain' plugin so all our accounts are AD accounts.