Searching for Issues

JIRA provides a powerful issue search facility. You can search for issues across projects, versions and components using a range of search criteria. If you need to find issues based on time-tracking details, then the standard search interface also allows you to search against the work logged on issues. JIRA also makes custom fields available as search criteria, allowing you to refine your searches even further.

You can also save your search as an issue filter in JIRA, allowing you to recall the same search and run it again or even share it with other users. Read more about issue filters.

On this page:

In this chapter:

Searching for issues

1. On the top navigation bar, click the 'Issues' tab. This will display information on the issue filter or search you currently have selected, if any, on the left hand side of the page. If you have an issue filter or search currently selected, the results will be displayed in the 'Issue Navigator' on the right hand side of the page. Otherwise, no results will be shown.
2. If you currently have an issue filter or search selected and wish to run a new search, click the 'New' link on the top left hand side of the page. The search form will display on the left-hand side of the screen.
   
   Several of the form items have contextual help available, denoted by the icon.
3. Type your search term(s) into the 'Query' box (see Performing Text Searches for help with this), and/or select other criteria from the drop-down boxes and check-boxes described below. The drop-down boxes and check-boxes allow you to narrow your search, be it to issues in a certain project, only issues that are marked as 'stoppers', only issues marked as 'enhancements', only issues reported by or assigned to a particular person, and so on.
4. Click the 'View' button to perform the search and keep the search form visible; or click the 'View & Hide' button to perform the search and hide the search form.

Searching particular projects or issue types

When using the search form, your selected Project(s) and Issue Type(s) determine what other fields are shown in the search form and what options you can see for these fields. For example, the 'Version' and 'Component' fields will only be available when searching for a single project, and will have different options for each project. When you change the project(s) or issue type(s), you may need to refresh the search filter in order to get the most up-to-date versions, components and custom fields. If a refresh is needed, a blue box will appear, containing a link for you to click.

Using the 'Issue Attributes' section

You can narrow your search by specifying particular values for the following fields:

• Reporter
• Assignee
• Status
• Resolutions
• Priorities

For example, to find issues reported by a particular person, select 'Specify User' in the 'Reporter' field. In the field that appears beneath, type a few letters of the person's name (first name or surname) to display a drop-down list:

Please note: if the user drop-down does not display, your administrator may have disabled the 'User Picker Auto-complete' feature for your JIRA instance.

Using the 'Dates and Times' section

You can narrow your search by specifying issues that were:

• Created after or before a particular date, or during a particular date range
• Updated after or before a particular date, or during a particular date range
• Due after or before a particular date, or during a particular date range
• Resolved after or before a particular date, or during a particular date range

Using the 'Work Ratio' section

The search form contains a 'Work Ratio' section, enabling you to search JIRA issues based on time-tracking details.

The 'Work Ratio' search is based on the Actual work logged against an issue versus the original Estimated work duration.

• Work Ratio Percentage = (Actual / Estimated Work) x 100
  You can enter a minimum, maximum or percentage range; the search will respectively return all issues above, below or within the specified percentage range.

Using the 'Custom Fields' section

Your administrator may have created custom fields for your JIRA system. Custom fields can be searched, but note that they will only appear in the search form on the left when appropriate. That is:

• Custom fields that relate to a particular project will only appear in the search form after you choose that project.
• Custom fields that relate to a particular issue type will only appear in the search form after you choose that issue type.