Learn Jira Query Language with JQL Cheat sheet and JQL Function

Knowing what fields, Values, operators, and keywords denote will result in an efficient query. Data is one of the most valuable resources in the world right now, but the way it is stored and accessed can impact its efficiency and usability. You can even create custom software that runs SQL queries to retrieve data and presents it in intuitive ways. This cheat sheet provides a comprehensive list of JQL commands, functions, and operators that can be used to search for issues in Jira.

jira query language cheat sheet

This can mean you’re unable to isolate issues with a specific inward or outward description if the link type’s name and either of the descriptions are the same. This is the case for the default “Blocks” link type, where the name and outward description are “blocks”. Search for issues jql contains that were created on, before, or after a particular date (or date range). Note that if a time-component is not specified, midnight will be assumed. Please note that the search results will be relative to your configured time zone (which is by default the Jira server’s time zone).

Top Tags in Software

For this example, let’s say we want to find all issues that are urgent and not done within a specific Epic link. In the above search, you’re searching for issues with an Epic Name (field) that is equal to (operator) “Audio Development” (value). A JQL query is a set of words and operators that define how Jira will narrow your search. JQL, or Jira Query Language, is a flexible tool that allows you to search for issues in Jira and pinpoint exactly what you are looking for. Values are the actual data in the field under consideration.

jira query language cheat sheet

This query will find all issues in the TEST project where the assignee is the currently logged in user. It uses the project field, the EQUALS operator, the value TEST,the AND keyword and the currentUser() function. Search for issues using the text field with the right syntax. You can use the syntax for text fields when searching for recent issues, specific issues (supported fields), and advanced search (when CONTAINS (~) operator is used). When searching issueLinkType, Jira searches all three properties.


Power users who employ Jira on a daily basis may already have a grasp of the Jira query language. But effective query writing skills can also be quite helpful to other members of the team. This is a brief introduction to using JIRA for project management in the IT and software development environments. Fields are columns that contain https://deveducation.com/ different types of information in the system (like issue type and priority). In addition to built-in JQL, the Atlassian Marketplace contains plugins with advanced JQL functionality. The Full-Text Search Attachments for Jira Plugin, for example, enables JQL statements to search attachments for the name, type, and content.

This cheat sheet provides an extensive list of JQL commands and their usage. With end of support for our Server products fast approaching, create a winning plan for your Cloud migration with the Atlassian Migration Program.

Is JQL similar to SQL?

The “WAS NOT IN” operator is used to search for issues where the value of the specified field has never been one of multiple specified values. The “WAS IN” operator is used to find issues that currently have or previously had any of multiple specified values for the specified field. The “NOT IN” operator is used to search for issues where the value of the specified field is not one of multiple specified values. In this query the “is empty” statement only includes issues where the value of the assignee field is blank.

jira query language cheat sheet

Add a comment