Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Here you’ll learn:

  • Where and how to use JQL Search Extensions.

  • What is Extended search, and why should you use it?

  • How to get comfortable using new keywords and functions.

On this page:

Table of Contents
minLevel1
maxLevel4
outlinefalse
styledefault
typelist
printablefalse
Info

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.

What is JQL Search Extensions for Jira Cloud (JSE)?

JSE is an app that extends Jira Cloud's search and reporting capabilities. It delivers additional keywords and functions not available in native Jira advanced search to improve the speed, precision, and relevance of your issue searches. Your queries can be saved as filters and used anywhere you would use a standard Jira filter.

What are JSE keywords and functions?

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 means 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.

...

Info

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 https://support.atlassian.com/jira-software-cloud/docs/use-advanced-search-with-jira-query-language-jql/

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.

...

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").

    JSE-where-to-use-functions.png

Tip

When you are starting out, keep the JQL functions reference handy to find the keywords and functions 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.

Extended Search filters

Extended Search filters are JSE queries that you save from the Extended Search page. Your Extended Search filters can be used anywhere you would use a standard Jira filter. For more information on creating, sharing, and managing filters, see Extended Search filters.

What’s the difference between advanced search in Jira and Extended Search?

Advanced search is Jira’s native JQL issue search feature. It allows you to search across all projects in your instance using Jira Query Language (JQL). You can save your queries as filters and use them in reporting features and share them with others to facilitate their searching and reporting tasks.

Extended Search is JSE’s issue search feature for Jira Cloud. Here, you can expand on Jira’s native search using JSE functions and keywords, save your queries as filters, and then use them in Jira in future searches and reporting. To open the Extended Search page, in the top navigation bar in Jira, select Apps > JQL Search Extensions for Jira.

Get started

The easiest way to start is to follow a simple scenario:

...