Saving your search as a filter

Searching for a filter

You can find and run any filters that you have created or that have been shared by other users.

1. Click the Search tab on the 'Manage Filters' page.
2. Enter your search criteria and click Search to run the search.
3. Your search results are displayed on the same page. Click the name of any issue filter to run it.

Tip: If the filter has been added as a favorite by many users, you may also be able locate it on the Popular tab of the Manage Filters page.

Updating a filter

You can update the name, description, sharing, favorite of any filters that you have created. If you want to edit a filter that was shared with you, either clone (aka copy) the shared filter, or ask your JIRA administrator to change the filter's ownership.

Update the filter's details:

1. Click the My tab on the 'Manage Filters' page.
2. Locate the filter you wish to update, click the cog icon > Edit.
3. The Edit Current Filter page displays, where you can update the filter details as required.

4. Click Save to save your changes.

Update the filter's search criteria:

1. Click the My tab on the 'Manage Filters' page.
2. Locate the filter you want to update and run it.
3. Update the search criteria as desired, and rerun the query to ensure the update is valid. You will see the word Edited displayed next to your filter name.
   
4. Click Save to overwrite the current filter with the updated search criteria. If you want discard your changes instead, click the arrow next to the save button, and select Discard changes.

Deleting a filter

1. Click the My tab on the 'Manage Filters' page.
2. Locate the filter you wish to delete, click the cog icon > Delete.

Cloning a filter

You can clone any filter – which is just a way of making a copy that you own – that was either created by you or shared with you.

1. Locate the filter you wish to clone and run it.
2. Update the search criteria as desired. Click the arrow next to the Save button, and select Save > Save as to create a new filter from the existing filter.
   

Adding a filter as a favorite

Filters that you've created or that have been shared by others can be added to your favorite filters. Favorite filters are listed in the menu under Issues > Filters, and in the left panel of the issue navigator.

1. Locate the filter you wish to add as a favorite.
2. Click the star icon next to the filter name to add it to your favorites.

Sharing a filter

Filters that you have created can be shared with other users via user groups, projects, and project roles. They can also be shared globally. Any filter that is shared is visible to users who have the 'JIRA Administrators' global permission. See Managing other users' shared filters below.

1. Click the My tab on the 'Manage Filters' page.
2. Locate the filter you wish to share, click the cog icon > Edit.

3. Update the Add Shares field by selecting the group, project, or project role that you want to share the filter with, and clicking Add. Note that you can only share filters with groups/roles of which you are a member.

   Why can't I see the filter's sharing configuration?

   You need the Create Shared Object global permission to configure sharing for a filter. Contact your JIRA administrator to obtain this permission.

4. Click Save to save your changes.

Tip: You can also share your filter by running it, then clicking Details > Edit Permissions.

Defining a filter-specific column order

You can add a defined column order to a saved filter, which displays the filter results according to the saved column order. Otherwise, the results are displayed according to your personal column order (if you have set this) or the system default.

Tip: To display your configured column order in a filter subscription, select 'HTML' for the 'Outgoing email format' in your User Profile. If you receive text emails from JIRA, you won't be able to see your configured column order.

To add a column layout to a saved filter:

1. Click the My tab on the 'Manage Filters' page.
2. Locate the filter you wish to update; click the filter's name to display the results. Be sure you are viewing the filter in the List view so that you see the columns.
3. Configure the column order as desired by clicking on the column name and dragging it to the new position. Your changes are saved and will be displayed the next time you view this filter.

To remove a filter's saved column layout:

1. Click the My tab on the 'Manage Filters' page.
2. Locate the filter you wish to update; click the filter's name to display the results. Be sure you are viewing the filter in the List view so that you see the columns.
3. Click the Columns option on the top right of the displayed columns, and select Restore Defaults in the displayed window.

Exporting column ordered issues

When the results of a saved filter are exported to Excel, the column order and choice of columns are those that were saved with the filter. Even if a user has configured a personal column order for the results on the screen, the saved configuration is used for the Excel export. To export using your own configuration, save a copy of the filter along with your configuration, and then export the results to Excel.

Subscribing to a filter

See Working with search results.