Search is a powerful tool for getting project data right at your fingertips. We’ll introduce the three ways you can search in Jira.
READ TIME: 6 minutes
This article created October 2020.
NOTE: This is a general introduction, with links to further resources in and out of the Atlassian Community.
Using search you can gain key project insights and answer most questions that are relevant to the team, either in an ongoing manner or with specific just-in-time team questions.
The three flavors of search in Jira—quick, basic, and advanced—can help you find important information about your projects. It’s designed to flex to your needs from simple text/keyword-based quick searches to complex, syntax-powered advanced searches using JQL (Jira Query Language).
Here’s a quick video overview (3 mins.) you can start with, or scroll down to read more about each type of search.
Quick search is a text/keyword-based tool accessed best from the main navigation at the top of the page. You can use it to search across multiple/all projects to find issues, boards, and queues, along with text within those items.
From the instant you interact with the quick search, you’ll see groupings of recent items you’ve worked on, the first of many ways Jira will assist you to efficiently find content.
You can enhance/modify a simple text/keyword quick search with syntax cues. Remember that this helps you narrow a search before you hit enter to trigger the search.
Here’s how it works using sample text/keyword(s):
We enter the search text/keyword "feature."
Immediately you see this text is in the summary for at least six issues in our Jira account.
Next, we add “NOT 1” to the search text/keyword.
You’ll see that the two issues containing “Feature NOT 1” are excluded from the results, while other instances of “feature” remain.
Here we modify the search to search for “feature” OR “sample,” with matching issues reflecting either of the two words.
As noted above, all this action is taken within the search field itself; Jira is predictively helping you find issues before you hit enter.
IMPORTANT: While search terms are not case sensitive, text-field search keywords such as NOT, OR, and AND must be capitalized.
How to use basic search
Basic search sounds like a “quick search,” but is actually a powerful tool to do complex queries without knowing how to use Jira Query Language (JQL).
The text box in basic search works much like that of quick search, but is limited to searching only issues.
All issues matching those criteria will be displayed in the Issues Navigator (i.e. where search results are displayed). You can then use filters to narrow the results.
Like quick search, syntax can be used with basic search to perform more complex queries.
The advanced search feature allows you to build structured queries with Jira Query Language, or JQL. You can specify criteria that cannot be defined in the quick or basic searches (e.g., ORDER BY clause). JQL is not a database query language, even though it uses SQL-like syntax.
Advanced search is a great way to configure your own query and then carry out a bulk action, such as finding every issue with a label attached to it and removing that label.
Filters are used to limit the issues displayed in search results. You’ll see Filters in the issues navigator on the left side navigation.
Filters are very helpful ways to sort and narrow results from any quick, basic, or advanced search.
For example, after performing a search you click on the Open issues filter (see left), the results will show all issues in all projects that have not been closed, or Done issues will show all the issues completed.
Filters are actually just a user-friendly face on powerful advanced search (JQL) queries. If you’re curious how JQL works, use the filters, then switch from basic search to JQL to see the query language behind the filter you selected.
This is a general overview of quick, basic, and advanced searches in Jira.
Dorin ShenAtlassian Team
Connect with like-minded Atlassian users at free events near you!Find an event
Connect with like-minded Atlassian users at free events near you!
Unfortunately there are no Community Events near you at the moment.Host an event
You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events