Filters

Filters and their usage

Power Admin for Jira provides you with an easy and convenient way to search for saved filters in a Jira instance. You can even search in the JQL queries of those filters. Additionally, you can view the whole query of a filter, open it in Issue Navigator, or copy it.

After finding a filter, you can visit its profile page in Power Admin to get a full report of its usage.

Find filters

  1. On Power Admin's Home page, select Filter from the drop-down, type the filter name or key, and start your search.

  2. On the Search results page, you can enable the Search in Query option and enter an ID, name, or JQL query in the search box. Power Admin will then search for а match in each filter's JQL query.

  3. You can filter further the results by owner and access. For this purpose, use the Owner and Access filters next to the search field.

  4. From the search results, click on the name of a filter. Then, the filter profile page appears.

Search results

After you search for a filter, the page with results shows the following information:

  • Name and ID of the filter - you can search for a filter by its name or ID.

  • JQL query of the filter - if the query is broken, there will be an error in the JQL section informing you about the problem.

  • Sharing state of the filter - Private or shared. Filters can be shared with other users directly or via user groups, projects, and project roles (read more).

  • Owner of a filter - name and state (active, inactive, or deleted) of the user that owns the filter.

  • Subscriptions - the number of users and groups subscribed to the filter.

When you hover over the JQL query of a filter, three available actions appear:

  • View in Issue Navigator - view the filter’s JQL entry on a new page in the Issue Navigator.

  • View see the whole JQL query in an inline dialog on the same page.

  • Copy - copy the JQL query to your clipboard.

Profile page

After finding your filter in the search results, you can open the filter's profile page and review the data gathered about where it is used in your Jira.

How does Power Admin for Jira track the filter usage?

To collect all the data about a filter's usage, Power Admin detects all the agile boards, dashboards, and filters where it is in use. It goes through their JQL entries and looks for references to the filter.

Power Admin also detects the number of subscriptions and shares of this filter.

Learn more about how Power Admin for Jira tracks usage information.

Usage information

On a filter’s profile page, you can see the following information:

  1. ID, owner, and JQL query.

  2. Sharing state of the filter - Private or shared.

  3. Number of subscriptions to this filter and shares with users, groups, or roles.

  4. Number and list of agile boards, dashboards, and filters where the filter is referenced/used.

If the filter’s JQL query is invalid, Power Admin will display an error in the JQL section along with a red error icon.

Actions

The following actions are available for filters:

  • Export - exports the filter usage information into a CSV file.

  • View in Issue Navigator - opens the filter in the Issue Navigator.

  • Copy query - copies the JQL query of the filter to your clipboard.

Locations

Location details are not available for the relation between filters and their dependent configuration elements (agile boards, filters, and dashboards).