Structure adds structure() JQL function that lets you search for issues that are added to a structure, or for all sub-issues of a certain issue in a structure.

In order to search for structure issues, you need to use Advanced Searching in JIRA and JQL.

structure() JQL function

To specify a structure condition in JQL, use the following format:

issue in structure(structureNameopt, parentIssueopt)

Function arguments:

structureName

Optional

The name of the structure. If you omit the structure name, the default Global Structure will be searched – unless it was removed from JIRA. Remember to enclose the name in double quotes ("") if it contains spaces or non-letters.

parentIssue

Optional

Use this parameter to select only part of the structure that consists of the specified parent issues and all its sub-issues of any level. If the issue specified is not added to the structure, an empty set is returned.

You can use structure ID instead of the structure name. You can see structure ID in the URL of the Structure Board if you open Manage Structure page and click on the structure.

Examples

If a user does not have access to structure, they will not be able to create new queries with the structure() function and existing queries will have structure() function return an empty set. However, the user will still see structure() function offered in the JQL completion drop-down.