Getting started with JQL Search Extensions

Welcome to JQL Search Extensions!

Here you’ll learn:

  • where and how to use JQL Search Extensions

  • what is Extended search and why you should use it

  • how to get comfortable with using new aliases and functions

Before you start using the app for the first time, check the status on Getting Started page. If it’s ready to use then go ahead. If the issues are still processing, wait a bit until they finish.

JQL Search Extensions (JSE)

JSE adds more than 50 new aliases that you can use in Jira.

There are two ways to use the new aliases:

  • in the Extended Search screen

  • in Jira advanced search

In both cases, you type in the new JQL alias in the search bar along with other JQL clauses. It’s super easy.

At first, keep the documentation handy to find the aliases you need. We autocomplete the aliases for you, so you only need to type the first few characters.

New JQL functions are available in Jira search but you need to expose them with filters. Extended Search is a page where, additionally to aliases, you can also use JQL functions.

You can create queries with functions and save them as filters to use in Jira.

Where to start?

Best way to start is to try going through a simple scenario:

  1. Go to the Extended Search screen: Apps → JQL Search Extensions → Extended Search

  2. In the documentation, find a function and an alias that you want to use.

No idea which one to try? Our recommendation:
- try linksCount alias by creating linksCount>0 query. It will return all issues that have links.
- try childrenOfEpicsInQuery function by creating issue in childrenOfEpicsInQuery("resolution is not empty") query. It will return all Stories of Epics that are done. You can enhance this query to issue in childrenOfEpicsInQuery("resolution is not empty") AND resolution is empty and it will return all unfinished Stories of Epics that are done.

3. Type in the query in the search bar on the Extended search screen and click “Search”

4. Now, save the query as a filter by clicking on “Save as filter”

5. Go to Jira advanced search and use your saved filter in the query by typing in filter="My filter name".

6. Now try using a few JQL aliases added by JSE in Jira advanced search.

How did it go? If you had any trouble with going through this scenario, reach out to us by creating a support request or book a demo to get a straight to the point no-nonsense consultation.