Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

On this page:

Table of Contents
minLevel2
maxLevel4
outlinefalse
typelist
printablefalse

Using filters in queries

To apply a filter to a JQL query, use the following expression:

filter='YOUR FILTER NAME'

Create a filter

  1. On the Extended Search page, perform a search with the desired JQL query.

  2. Once the search results are displayed, click Save the query as a filter in the upper-right corner.

  3. In the Save query as a filter window, enter a filter name, then click Save.

    You can now search for your filter in Jira search and everywhere else, e.g., filter='All Blue Mountain'.

Filters are shared with other authenticated users by default. You can make it private or share it with more people in Jira filter permissions management.

List Extended Search filters

The Extended Search filters page displays the details of your saved filters. Here, you can review a filter's JQL query and when it was last reindexed (synced). Filters are automatically synced every few minutes. You can manually sync, edit, rename, or delete a filter from the More options menu in the Actions column.

...

Sync a filter

Filters are automatically synced every few minutes, but if you have several filters used across your instance, you can prioritize a sync to ensure critical filters are up to date when you need them.

...

  1. Go to the Extended Search filters page and locate the required filter.

  2. In the Actions column, click the More options icon, then select Sync filter. A status message displays.

  3. Once the sync is complete, click OK. Do not close the web page during a manual sync.

Edit a filter query

To edit a filter query:

  1. Go to the Extended Search filters page and locate the required filter.

  2. In the Actions column, click the More options icon, then select Edit query.

  3. Enter a new query and click the Search icon.

  4. Click Save.The edited filter appears on the Extended Search filters page.

Rename a filter

Info

If you change the filter name, you need to update all references to the filter name in your Jira JQL queries.

...

  1. Go to the Extended Search filters page and locate the required filter.

  2. In the Actions column, click the More options icon, then select Edit name.

  3. Enter a new filter name, then click Save.

Delete a filter

Info

Do not delete filters directly in Jira. Always do it in the Extended search filters screen.

...

If the filter's owner changes, it is removed from the current user's filter list but not from the system. The new owner can use the filter.

Change a filter owner

Admins can change the owner of shared filters in Jira in a standard way. Once the owner is changed in Jira, you should wait a few minutes for JQL Search Extensions to detect the change.

...

  1. From the top navigation bar, select Filters > View all filters and locate the required filter.

  2. Select the More options icon, then select Change owner from the list of options.

  3. Select a new owner, then click Change owner.

Filter permissions

Filters are shared with other authenticated users by default.

...

  1. From the top navigation bar, select Filters > View all filters and locate the required filter.

  2. Select the More options icon, then select Edit from the list of options.

  3. Under Viewers or Editors, select the desired permissions, then click Save. You can give edit permissions to groups or individual users. Learn more about sharing Jira filters in Atlassian’s documentation

Limitations

Some technical limitations need to be followed:

...