Get started with Advanced Search and JQL

People moving Jira tickets

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:

jql syntax 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. 

Results dashboard

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)

Get started as a developer

Learn the 6 steps to get started in Jira as a developer.

Developer tool integrations

Learn how Jira works helps manage your Git workflows.

Gain Project Insights through JQL

Keep your projects at peak efficiency with free JQL lessons from Atlassian University

Get started with Jira Software free today