subtasks()

This function returns the list of sub-tasks of the current issue.

Syntax

subtasks() #Output: Issue list

Parser expression	Description
subtasks()	This example returns a list with the current issue's sub-tasks.

This function returns an ISSUE LIST.

If there are no sub-tasks, the function returns an empty ISSUE LIST.

Variant where you can specify multiple parent issues as an issue list.

Syntax

subtasks(issueList) #Output: Issue list

Parser expression	Description
subtasks(linkedIssues())	This example returns the list of the linked issues' sub-tasks.

Parameters used in this function

Parameter	Input (data type)	Description
`issueList`	ISSUE LIST	Any given issue list. Usually this value is retrieved from a function (e.g. linkedIssues() or subtasks()).

This function returns an ISSUE LIST.

If there are no sub-tasks, the function returns an empty ISSUE LIST.

Variant where you can specify multiple parent issues as a comma separated list of issue keys.

Syntax

subtasks(issueKeys) #Output: Issue list

Parser expression	Description
subtasks(%{parent.key})	This example returns the list of sub-tasks of the parent issue, i.e. sibling sub-tasks including the current sub-task.
subtasks("TASK-1, TASK-2")	This example returns the list of sub-tasks of the specified issues.

Parameters used in this function

Parameter	Input (data type)	Description
`issueKeys`	TEXT	A comma separated list of issue keys.

This function returns an ISSUE LIST.

If there are no sub-tasks, the function returns an empty ISSUE LIST.

Use cases and examples

Use case	Workflow function	Field type	Automated action	Parser functions
Difference between the current date and the earliest due date		Number		min() fieldValue() subtasks()
Block a transition until all sub-tasks have certain fields populated	Logical validator Logical condition			count() filterByPredicate() subtasks()
Sum up value in parent issue on field change in sub-tasks			Update field action	fieldValue() sum() subtasks()
Clone epic, tasks and sub-tasks	Create issue			toString() toStringList() issueKeysToIssueList() replaceFirst() first() fieldValue() textOnStringList() findModify() subtasks() issuesUnderEpic()
Number of open subtasks		Number		count() filterByPredicate() subtasks()
Components from all sub-tasks		Text		toString() distinct() fieldValue() subtasks()
Total remaining estimate in an epic (all linked issues)		Number		sum() fieldValue() issuesUnderEpic() subtasks()