Documentation for JIRA 4.4. Documentation for other versions of JIRA is available too.
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 'simple 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.
Screenshot: The 'Simple Search' form
To hide the left-hand column and display your search results in full-screen width, click the icon.
To expand/collapse individual sections of the left-hand column, click the icon.
While you are interacting with JIRA, your current search will be remembered, along with whether the search you are using is new, a saved search, or a modification of a saved search.
On this page:
In this chapter:
You can specify particular text to search for in any or all of the following fields:
For details about how to refine your search term, please see Performing Text Searches.
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.
You can search for issues in a particular:
Screenshot: The 'Components' section
To learn more about components and versions, please see What is a Project?.
You can specify particular values for the following fields:
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
You can search for issues that were:
Screenshot: The 'Dates and Times' 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.
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
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: