DoIT Shared Tools - JIRA - Create and Find Issue Filters

This document will show you how to create an issue that can be then be added to a gadget and placed on a JIRA Dashboard. In the past, the specific collections have been called queries, issues and searches.

Search for an Existing Issue Filter

  1. Open JIRA.
  2. On the top navigation bar, click on Issues (see the red box in the image below).

    Issues tab in JIRA

  3. A drop-down menu will appear.
  4. Select Manage Filters from that menu (see the red box in the image below).

    Issues Menu to Manage Filters link in dropdown

  5. From the Manage Filters screen, you may search for an Issue filter. There is a left navigation bar where you may search:

    • Filters marked as a Favorite.
    • Filters you own
    • Popular filters
    • Search by name of the filter
    • Search by Owner Name

    Manage filters options

Create a New Issue Filter

  1. Issues > Current Search

  2. Click on the New Search button (see the red box in the image below).

    New Search button

  3. You will be presented with a number of fields which you use to narrow your search:
  • Select Project(s)
  • Select Issue Type(s)
  • Select Status Type(s)
  • Select Assignee
  • Look at the other fields available under More.

        Create filters option

    • Click the Submit button and carefully name your Filter. Take note of it if you will be applying it to a Gadget on a Dashboard, etc.

       Save filter name carefully

Limit Filter Visibility to Group or Project

  1. Locate the filter you already created:

    Issues > open Long Dropdown list > select Manage filters at the bottom of the menu.

    The image below shows the Manage filters link at the bottom of the long menu.

    Click on manage filters


  2. This will open the Manage Filters menu. 

    The image below shows the Manage Filters selections; Favorite, My, Popular and Search.

    my filters

  3. Did YOU create the filter? If so, click on My.

    Select My > Click on your filter in the Name column > Leads to selected filter and content.

  4. Next to the filter name is the Details link. Click on that link.

    Note: The image below shows a dark star, which means it is a "favorite". To unfavorite, click on the star.


    click on details

  5. A pop-up window will appear displaying the current permissions. To update permissions, click on Edit permissions link in the middle of the pop-up.

    The image below shows a red box around the Edit Permissions  link in the Filter Permissions pop-up.


    Edit permissions link


  6. From the Edit Current Filter screen:

    You may limit your group to a specific viewer/ editor.

    or

    You can select a specific Project or JIRA user group.

    The list of JIRA User Groups that appear are User Groups that you, yourself,  have access to. (The red arrow in the image below displays all JIRA User Groups that are accessible).



    Dropdown menu of Jira User Groupa


    Important: After you select a Group and the Group Name, Click on the + Add  on the same line.

    Your Group or project should then appear above under Viewers


  7. If you don't see the JIRA User Group name you need, contact the Shared Tools Team and request that a JIRA Super Admin add you to a specific User Group.

  8. Finally, click on Save at the bottom of the screen to save all your work.

Creating Queries via JQL

The advanced search allows you to build structured queries using the Jira Query Language (JQL) to search for issues. You can specify criteria that you can't define in the quick or basic searches (the ORDER BY clause, for example).

JQL is not a database query language, even though it uses SQL-like syntax.

Please look at Atlassian's documentation with details on how to create a query via JQL.