Searching for Issues

Specifying a Query

You can specify particular text to search for in any or all of the following fields:

• Summary
• Description
• Environment
• Comments

For details about how to refine your search term, please see Performing Text Searches.

Searching particular Projects or Issue Types

The Project and Issue Type fields determine which other fields are shown in the search form and what options you can see for these fields. For example, the 'Version' and 'Component' fields (see below) 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:

If you search on a single project, JIRA will remember that as your selected project and will default to that project on the "Browse Project" and "Create Issue" screens.

Using the 'Components/Versions' section

You can search for issues in a particular:

• Component
• Affects Version
• Fix Version

Screenshot: The 'Components' section

To learn more about components and versions, please see What is a Project?.

Using the 'Issue Attributes' section

You can specify particular values for the following fields:

• Reporter
• Assignee
• Status
• Resolutions
• Priorities
• Labels

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 of matching names:

Alternatively, click the icon to display a pop-up list of all names on your JIRA system.

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

Screenshot: The 'Issue Attributes' section

Using the 'Dates and Times' section

You can search for 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
• Resolved 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

Screenshot: The 'Dates and Times' section

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 = (Time Spent / Original Estimate) 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.

Screenshot: The 'Work Ratio' section

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.