robots noindex
The basic search provides a user-friendly interface that lets you define complex queries, without needing to know how to use JQL (advanced searching).

tip/resting Created with Sketch.
  • If you don't have complex search criteria, try quick search instead.
  • If you're comfortable with the Jira Query Language (JQL), you can try the advanced search.

Basic search

  1. Choose the Jira icon ( or ) > Issues and filters.
  2. Select Search issues
    • If the advanced search is shown instead of the basic search, click Basic (next to the  icon).

      Why can't I switch between basic and advanced search?

      In general, a query created using basic search will be able to be translated to advanced search, and back again. However, a query created using advanced search may not be able to be translated to basic search, particularly if:

      • the query contains an OR operator (note you can have an IN operator and it will be translated, e.g. project in (A, B))
        • i.e. even though this query: (project = JRA OR project = CONF) is equivalent to this query: (project in (JRA, CONF)), only the second query will be translated.
      • the query contains a NOT operator
      • the query contains an EMPTY operator
      • the query contains any of the comparison operators: !=, IS, IS NOT, >, >=, <, <=
      • the query specifies a field and value that is related to a project (e.g. version, component, custom fields) and the project is not explicitly included in the query (e.g. fixVersion = "4.0", without the AND project=JRA). This is especially tricky with custom fields since they can be configured on a Project/Issue Type basis. The general rule of thumb is that if the query cannot be created in the basic search form, then it will not be able to be translated from advanced search to basic search.
  3. Enter the criteria for the search. You can search against specific fields and/or search for specific text. 

    • If you are searching against a field and can't find the field you want, or the field is displaying greyed out text, see the Troubleshooting section below. 
    • If you are searching for text, you can use special characters and modifiers in your search text, such as wildcards and logical operators. See Search syntax for text fields
  4. The search results will automatically update in the issue navigator, unless your administrator has disabled automatic updates of search results. If so, you will need to click the Update button on the field drop-down after every change.

Run a saved search

Saved searches (also known as filters) are shown in the sidebar. If you can't see the sidebar, hover your mouse over the left side of the screen and click to expand it.

To run a filter—for example, My open issues—click the filter name. The filter sets the search criteria and displays the results.

Clicking some filters, like the Viewed recently filter, will switch you to the advanced search as the basic search can't represent the ORDER BY clause in this filter.


Why can't I find the field I want to choose?

Some fields are only valid for a particular project/issue type context. For these fields, you must select the applicable project/issue type. Otherwise, the field is not available for selection.

Why are the field criteria displaying in gray text?

Some fields are only valid for a particular project/issue type context. If you choose a field in your search, then remove all projects/issue types that reference the field, then the field is invalid. The invalid field does not apply to your search and displays in grey text.

Why is there a red exclamation mark in my field?

Some field values are only valid for a particular project/issue type context. For example, you may have configured a project to use a status In QA Review in its workflow. If you select this project and status in your search, then change the search to filter for a project that doesn't use In QA Review, the status will be invalid and ignored in the search.

Why don't my search results automatically update?

Your search results will always update automatically whenever any fields are changed, provided that your administrator has not disabled automatic updates of search results. Ask your administrator whether they have disabled automatic updates of search results.