This site is moving soon to become part of an integrated Appfire documentation and information site for our apps. This site will remain available during the transition to our new and improved site. Once this site is moved over, this banner will be updated with the new site link for easy access.

Take a look here! If you have any questions please email support@appfire.com

Getting Started with JQL Search Extensions

Owned by Weronika Spaleniak (Unlicensed)
Last updated: Aug 16, 2023 by Deborah Scott
2 min read

Welcome to JQL Search Extensions for Jira Cloud

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

When you are starting out, keep the JQL functions reference 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?

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

  1. Go to the Extended Search page: Apps > JQL Search Extensions.

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

Not sure which one to try?

Our recommendations:
- try the linksCount alias by creating linksCount>0 query. It will return all issues that have links.
- try the 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 the query in the search bar on the Extended Search page then click Search.

4. To save the query as a filter, click Save the query as a filter.

5. In the Filter name input field, type a name for your filter, then click Save. Choose a name that helps you identify the filter in a list of filters, for example, My Links Count.

6. Click Show in Jira search to apply your filter in Jira Advanced search. Your filter search results are displayed in a new tab in Jira.

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

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