Subtasks

Owned by Deborah Scott
Last updated: Nov 08, 2024 by Deborah Scott
2 min read

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

On this page:

On this page:

Subtasks 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.

subtasksOfParentsInQuery()

For a given JQL subquery, it finds subtasks of resulting parent issues.

Examples

issue in subtasksOfParentsInQuery("status='Done'") and status='To Do' finds subtasks that are in progress and have finished parents
issue in subtasksOfParentsInQuery("assignee=currentUser()") finds subtasks of my issues

Subtasks JQL keywords

parentSummary

Search for subtasks with a parent's summary containing a particular text. 

Supported operators

=

!=

~

!~

>

>=

<

<=

IS

IS NOT

IN

NOT IN

WAS

WAS IN

WAS NOT

WAS NOT IN

CHANGED

=

!=

~

!~

>

>=

<

<=

IS

IS NOT

IN

NOT IN

WAS

WAS IN

WAS NOT

WAS NOT IN

CHANGED

Examples: 

Find subtasks where the parent summary contains the text Test.

parentSummary ~ "Test"

parentPriority

Search for subtasks with a parent that has particular priority.

Supported operators

=

!=

~

!~

>

>=

<

<=

IS

IS NOT

IN

NOT IN

WAS

WAS IN

WAS NOT

WAS NOT IN

CHANGED

=

!=

~

!~

>

>=

<

<=

IS

IS NOT

IN

NOT IN

WAS

WAS IN

WAS NOT

WAS NOT IN

CHANGED

Examples

Find subtasks where the parent has the Blocker priority. 

parentPriority = Blocker

parentIssueType

Search for subtasks with a parent of a particular issue type.

Supported operators

=

!=

~

!~

>

>=

<

<=

IS

IS NOT

IN

NOT IN

WAS

WAS IN

WAS NOT

WAS NOT IN

CHANGED

=

!=

~

!~

>

>=

<

<=

IS

IS NOT

IN

NOT IN

WAS

WAS IN

WAS NOT

WAS NOT IN

CHANGED

Examples

Find subtasks with a parent of issue type "Test".

parentIssueType = "Test"

parentStatus

Search for subtasks with a parent of a particular status.

Supported operators

=

!=

~

!~

>

>=

<

<=

IS

IS NOT

IN

NOT IN

WAS

WAS IN

WAS NOT

WAS NOT IN

CHANGED

=

!=

~

!~

>

>=

<

<=

IS

IS NOT

IN

NOT IN

WAS

WAS IN

WAS NOT

WAS NOT IN

CHANGED

Examples  

Find subtasks with a parent that is the In Progress status. 

parentStatusCategory

Search for subtasks with a parent of a particular status.

Supported operators

=

!=

~

!~

>

>=

<

<=

IS

IS NOT

IN

NOT IN

WAS

WAS IN

WAS NOT

WAS NOT IN

CHANGED

=

!=

~

!~

>

>=

<

<=

IS

IS NOT

IN

NOT IN

WAS

WAS IN

WAS NOT

WAS NOT IN

CHANGED

Examples 

Find subtasks with a parent in the To Do status.