Versions Compared

Key

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

...

Info

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

On this page:

Table of Contents
minLevel1
maxLevel3
outlinefalse
styledefault
excludeTry it free
typelist
printabletrue

Jira hierarchy JQL functions

Info

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.

...

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.

...

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.

...

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.

...