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.