Versions Compared

Key

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

Extended Search is a new way to perform complex searches in Jira. It improves your search experience over Subqueries in the following ways:

✅ You can see the results immediately without any additional indexing steps.
✅ You can save the query as a Jira filter and use the filter everywhere in Jira.
✅ As with standard Jira filters, you can control the filter permissions.
✅ Saved filters perform better than Subqueries and are more reliable.

...

Deprecation of Subqueries feature

From October 2023, the Subqueries feature is no longer available in JQL Search Extensions. This change affects customers with saved JQL subqueries who installed the app beforeApril 2021.

The 6-month deprecation plan was communicated to these customers with recommendations to convert any subqueries through Extended Search before the feature was deprecated. Extended Search provides an equivalent function for every subquery JQL keyword with better performance and reliability.

There is an equivalent function for every Subquery JQL alias. The full list of available functions is listed on the Extended search page. Have a look at the next section to see the mapping between Subqueries JQL aliases and new functions. It’ll help you to create your new queries.

...

The big difference is that you can use the nested query “component=UI” directly in your main query and without the need to create and index a subquery first. You can even narrow down you your query further:

issue in epicsOfChildrenInQuery("component=UI") and project in (ACME, SP)

If you want to To use the query anywhere else in Jira, simply save it as a filter.

Functions mapping

The following table list lists Subquery JQL aliases and their corresponding Extended Search functions. Use this mapping to migrate your subqueries.

Subquery JQL call

Extended Search function call

epicOfQuery=”subquery”

issue in epicsOfChildrenInQuery("subquery")

issuesFromEpicsInQuery=”subquery”

issue in childrenOfEpicsInQuery("subquery")

linkedByQuery=”subquery”

issue in linkedIssuesOfQuery("subquery") - matches both sides of the link

issue in linkedIssuesOfQuery("subquery", "link name") - only matches the links with a specific link name

linksQuery=”subquery”

same as linkedByQuery above

parentOfQuery=”subquery”

issue in parentsOfSubtasksInQuery("subquery")

subTaskOfQuery=”subquery”

issue in subtasksOfParentsInQuery("subquery")

issuesInQuery=”subquery”

Simply save your Extended Search query as a Jira filter and use the filter query:

filter="My Extended Search filter"