Versions Compared

Key

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

You can save your queries as Jira filters and use them everywhere in Jira. This powerful feature lets you use your queries in reports, Jira search, automation, and even other Jira apps.

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'

...

What are Extended Search filters?

Extended Search filters are saved Extended Search queries that can be used anywhere in Jira, just like your other Jira filters. Once you save a query in Extended Search, it is available on the Extended Search filters page and in your list of Jira filters.

You can use your filters in reports, Jira search, automation, other Appfire apps, and even third-party Jira apps. You can access your Extended Search filters from the Extended Search filters page and in the list of Jira filters in your instance.

Extended Search filters page

Jira filters list including Extended Search filters

Image Added

JSE-filters-in-Jira-list.pngImage Added

Info

There are important differences to remember when managing filter permissions and editing filter names and queries. The following sections explain where to perform specific actions.

Create an Extended Search 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.

    Image RemovedJSE-Extended-Search-save-button.pngImage Added

  3. In the Save query as a filter window, enter a filter name, then click Save. Filter names should be unique.

    Image RemovedJSE-Save-query-as-filter.pngImage Added

    You can now search for with your filter in Jira search and everywhere else, e.g., filter='All Blue Mountain'."All child levels - all projects".

Info

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.

Use Extended Search filters in JQL queries

You can apply an Extended Search filter to a JQL query in Jira, Extended Search, and in other applications using the following expression:

filter="YOUR FILTER NAME"

Extend other apps

Saved Extended Search filters can be used in other apps for more refined issue searches. For example, you can use an Extended Search filter to set the scope for post functions in JSU Automation Suite for Jira Workflows and in JMWE to set the scope for event-based and scheduled actions.

...

See App integrations to learn more about how you can use filters in other Appfire apps, Jira, and third-party solutions.

Use filters in reports and dashboards

You can use your Extended Search filters in your Jira dashboard gadgets for more precise reporting. See our use cases to learn how.

Manage Extended Search filters

The Extended Search filters page displays the details of your saved Extended Search filters. HereIf you have several filters, 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 columnsearch by filter name and owner.

To view the Extended Search filters page:

  1. Go to Apps > JQL Search Extensions.

  2. In the left sidebar, select Extended Search filters. The list of Extended Search filters displays.

From the Actions menu, you can:

  • Open the filter in Jira search,

  • Manually sync the filter,

  • Edit the filter JQL,

  • Edit the filter name, and

  • Delete a filter.

Info

Editing or deleted an Extended Search filter should always be done from the Extended Search filters page, not directly in Jira.

...

Sync a filter manually

Info

Filters that you regularly use are automatically indexed (synced) every few minutes

...

. If you do not use a filter for 7 days or more, it isn’t synced automatically.

If several filters are used across your instance, you can prioritize a sync to ensure critical filters are up to date when you need them.needed. The Last Reindexed column shows the time of the last sync and the

Status
titleno sync
status of filters that are not included in the automatic sync process.

...

To perform a manual sync:

  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 from the list of actions. A status message displays.

  3. Once the sync is complete, click OK Confirm. 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

Infonote

If you change the filter name, you need to update all references to the filter name in your Jira JQL queries and any third-party apps. Filter names should be unique.

To change a filter name:

  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

Infonote

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

To delete a filter:

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

  3. Click Delete in the confirmation window to confirmproceed.

Filters are normally deleted in Jira during this process. If the filter was deleted in Jira before the deletion being deleted in JQL Search Extensions, you can still delete the filter it from a list.

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

Filter owners

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

To change a filter owner:

  1. From the top navigation bar in Jira, 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

...

  1. JSE-filters-change owner.pngImage Added
Info

You can’t reverse a change to the filter owner. Only the new owner can make changes to the permissions.

Share filters

Extended Search filters are shared with other authenticated Jira users by default.

To change the filter permissions in Jira:

  1. From the top navigation bar in Jira, 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 Add. You can give edit permissions to groups or individual users. Learn more about sharing Jira filters in Atlassian’s documentation

    Image Removed

    .

  4. Once you have made all the required changes, click Save.

    JSE-share-filters-in-Jira.pngImage Added

Limitations

Some technical Note the following limitations need to be followedExtended Search filters:

  • currentUser(), votedIssues(), watchedIssues() always use the filter owner user session and evaluate to the filter owner userFilters are synced every few minutes, which might delay accurate filter results.

  • If you have not used a filter for seven days or more, it isn’t synced automatically. You can perform a manual sync to refresh your filter data anytime. Refer to the Extended Search filters page to confirm the last time your filters were synced correctly.A large number of filters can increase the sync time.

Info

Do not edit the JQL of a filter directly in Jira. The JQL is overwritten periodically by our sync service.

...