Get started with Advanced Search and JQL
Using search in Jira Software can help you gain key project insights and answer questions that are relevant to the team. 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).
Advanced search is a powerful tool for getting project data right at your fingertips. Search issues across all projects using the Jira Query Language (JQL). Query results can be saved and used as filters and views across Jira (including boards).
1. In the top navigation bar, select Filters.
2. Select Advanced issue search. (shortcut g + i)
3. Use quick filters for basic search or switch to JQL for advanced search.
4. (Optional) Switch between list and detail view by clicking the Change Views button on the top right of the screen. (shortcut t) List view allows you to scan a large number of issues and customize the number of columns displayed.
Learn JQL syntax
A simple query in JQL (also known as a “clause”) consists of a field, followed by an operator, followed by one or more values or functions. For example:
Watch this video tutorial to see it in action:
Find the full list of available fields, operators, and additional resources here:
Developer use cases
Advanced search using JQL can offer tremendous insight into your daily tasks as a developer.
- For example you can set up queries that answer common questions such as:
Which of my issues have changed since the last login?
updated > lastlogin() AND assignee = currentUser()
- If you connect your developer tools you can also search for across Git information. For example:
Which of my issues have an open pull request?
development[pullrequests].open AND assignee = currentUser()
- The same is possible if you connect your CI / CD or feature flagging tools:
Show me all my issues that have more than two failed build events.
development[builds].failing > 2 AND assignee = currentUser()
Visualize results on your dashboard
You easily add saved searches to your Jira dashboard. This helps create a personal view of the most important Jira issues and changes that might relate to your daily tasks.
New to dashboards in Jira? Learn more about reporting best practices and create your first dashboard today.
1. From the Advanced Search screen, click Export
2. Choose Create Dashboard Gadget
3. Select Filter Results (or another visualization option)
4. Select Save to Dashboard to add the Gadget (it will default to your personal dashboard)