Get started

On this page:

1 What are keywords and functions?
- 1.1 JSE keywords
- 1.2 JSE functions
2 Where can I use JSE?
- 2.1 JSE keywords
- 2.2 JSE functions

Before using the app for the first time, check the status on the in-app Get Started page. If the Jira issues are still processing, wait until the process is complete. Using the app before the initial indexing is complete will result in inconsistent or inaccurate results.

What are keywords and functions?

JQL Search Extensions (JSE) provides over 50 keywords and functions to deliver flexibility and precision to your issue searches in Jira Cloud.

JSE keywords

JSE keywords reference issue properties and act as terms for indexed search results. They make it faster and easier to build your searches in Jira Query Language (JQL). Auto-complete and suggestions also mean you don’t have to memorize all the keywords or operators.

Examples of keywords are CommentedBy or AttachmentExtenstion. A simple JQL clause could be AttachmentExtension = png. This returns all issues that have an attached PNG file.

JSE functions

JSE functions add precision to your searches using the parameters that you define for the query or calculations within the parentheses. Examples of functions are childrenOfIssuesInQuery() or linkedIssuesOfQuery()

When using a function, your query begins with issue in, for example,
issue in linkedIssuesOfQuery("project=ACME", "is blocked by") finds issues that block project ACME.

To use JQL Search Extensions for Jira, you should know how to write and structure a JQL query. You should understand how to use functions and keywords to build relevant and precise search results. If you need help with JQL, refer to Atassian’s support documentation Use advanced search with Jira Query Language (JQL) | Jira Cloud | Atlassian Support

Where can I use JSE?

JSE keywords

In Jira advanced search
In JSE’s Extended Search page

In either case, type the JQL keyword or combine it with other JQL clauses in the issue search field.

Screenshot of Extended Search with a JQL query using a keyword.

JSE functions

In the Extended Search page
You can create queries with functions and save them as filters to use in Jira. All functions are preceded by issue in, for example, issue in dateCompare("duedate < resolved").

When you are starting out, keep the list of our JQL functions and keywords handy to find the ones you need. The Extended Search page also has a cheat sheet so you can find what you need, copy the syntax, or discover other functions and keywords.