Issue hierarchy

Powerful generic functions that support standard Jira hierarchy and Advanced Roadmaps.

The examples on this page describe how to build a JQL search using JQL Search Extensions.

On this page: 1 Jira hierarchy JQL functions 1.1 parentsOfIssuesInQuery() 1.2 parentsOfIssuesInQueryRecursive() 1.3 childrenOfIssuesInQuery() 1.4 childrenOfIssuesInQueryRecursive()

On this page: 1 Jira hierarchy JQL functions 1.1 parentsOfIssuesInQuery() 1.2 parentsOfIssuesInQueryRecursive() 1.3 childrenOfIssuesInQuery() 1.4 childrenOfIssuesInQueryRecursive()

Jira hierarchy JQL functions

JQL functions are accessible from the Extended Search page or Extended Search filters in Jira advanced search. When using functions, the issues returned are based on the subquery defined in parentheses.

parentsOfIssuesInQuery()

For a given JQL subquery, it finds parents of resulting issues. It supports Advanced Roadmaps “Parent Link” and a standard Jira Hierarchy Epic → Story → Subtask.

Also, refer to ParentsOfIssuesInQueryRecursive.

Examples

issue in parentsOfIssuesInQuery("project='ACME' and type=Epic") finds all parents of epics in project ACME. Parents of epics are usually called Initiative.
issue in parentsOfIssuesInQuery("assignee=currentUser()") finds parents of all of my issues.

parentsOfIssuesInQueryRecursive()

For a given JQL subquery, it finds issues in the hierarchy above the resulting issues up to an optional depth. It supports Advanced Roadmaps “Parent Link” and a standard Jira hierarchy Epic → Story → Subtask.

Examples

issue in parentsOfIssuesInQueryRecursive("project='ACME' and type=Epic") finds all parents of epics in project ACME, and parents of parents, and so on. Parents of epics are usually called Initiative.
issue in parentsOfIssuesInQueryRecursive("assignee=currentUser() and issueType in subtaskIssueTypes()", 2) finds parents of my subtasks and epics of the parents, skips anything above epics.

childrenOfIssuesInQuery()

For a given JQL subquery, it finds children of resulting issues. It supports Advanced Roadmaps “Parent Link” and a standard Jira hierarchy Epic → Story → Subtask. Also, have a look at ChildrenOfIssuesInQueryRecursive.

Examples

issue in childrenOfIssuesInQuery("project='ACME' and type=Initiative") finds all epics in initiatives in project ACME.
issue in childrenOfIssuesInQuery("assignee=currentUser()") finds children of all of my tickets.

childrenOfIssuesInQueryRecursive()

For a given JQL subquery, it finds issues in the hierarchy below the resulting issues up to an optional depth. It supports Advanced Roadmaps “Parent Link” and a standard Jira hierarchy Epic → Story → Subtask.

Examples

issue in childrenOfIssuesInQueryRecursive("project='ACME' and type=Initiative") finds all epics, stories, and subtasks in initiatives in project ACME.
issue in childrenOfIssuesInQueryRecursive("assignee=currentUser() and type=Initiative", 2) finds epics and stories of all of my epics and skips the subtasks.