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.

Jira hierarchy JQL functions

JQL functions are accessible from the Extended Search page or Extended Search filters in Jira advanced search.

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 parentsOfIssuesInQuery("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.