Subtasks

Subtasks JQL Functions

parentsOfSubtasksInQuery()

Retrieves the parent issues of subtasks that match a specified JQL subquery.

Examples:

issue in parentsOfSubtasksInQuery("status='To Do'") and status='Done' finds completed issues that have subtasks still in ‘To Do’ status.
issue in parentsOfSubtasksInQuery("assignee=currentUser()") retrieves parent issues of your subtasks.

subtasksOfParentsInQuery()

Finds subtasks of parent issues that match a given JQL subquery.

Examples:

issue in subtasksOfParentsInQuery("status='Done'") and status='To Do' identifies subtasks that are in ‘To Do’ status with parents that are completed.
issue in subtasksOfParentsInQuery("assignee=currentUser()") retrieves subtasks of issues assigned to you.

Subtasks JQL Keywords

ParentSummary

Searches for subtasks whose parent summaries contain specific 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

Finds subtasks where the parent’s summary includes the word “Test”.

parentSummary ~ "Test"

ParentPriority

Finds subtasks whose parents have a 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

Retrieves subtasks with parents set to “Blocker” priority.

parentPriority = Blocker

ParentIssueType

Locates subtasks with parents of a specific 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

Finds subtasks whose parents are of the issue type “Test”.

parentIssueType = "Test"

ParentStatus

Searches for subtasks whose parents are in a certain 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

Identifies subtasks with parents currently in “In Progress” status.

parentStatus = "In Progress"

ParentStatusCategory

Finds subtasks whose parents belong to a specific status category.

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

Retrieves subtasks with parents in the “To Do” status category.

parentStatusCategory= "To Do"

SubtaskCount

Searches for issues based on the number of their subtasks.

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

Finds issues that have one or more subtasks.

subtasksCount > 0

SubtaskSummary

Locates issues that have subtasks containing particular text in their summaries.

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

Finds issues whose subtasks’ summaries include the word “Test”.

subtaskSummary ~ "Test"

SubtaskKey

Finds issues that have subtasks with a specific issue key.

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

Retrieves issues containing a subtask with the key “TEST-1”.

subtaskKey = TEST-1

SubtaskPriority

Searches for issues with subtasks of a 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

Finds issues that have subtasks marked as “Blocker” priority.

subtaskPriority = Blocker

SubtaskIssueType

Identifies issues with subtasks of a specific 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

Retrieves issues that have subtasks of the issue type “Test”.

subtaskIssueType = "Test"

SubtaskStatus

Finds issues that have subtasks in a certain 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

Identifies issues with subtasks currently in “In Progress” status.

subtaskStatus = "In Progress"

SubtaskStatusCategory

Searches for issues with subtasks belonging to a specific status category.

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

Retrieves issues that have subtasks in the “To Do” status category.

subtaskStatusCategory = "To Do"