Configuring sub-tasks

As a Jira administrator, you can create sub-task issue types to split up larger pieces of work into tasks that can be assigned and tracked separately by your teams. Sub-tasks are enabled by default; however, you can choose to disable them if your teams only need to work with standard issue types. You can also create workflow conditions to ensure that all sub-tasks are completed before a parent issue can be resolved. 

How to enable or disable sub-task issue types

Sub-tasks are enabled by default. Note that you can't disable sub-tasks if one or more sub-tasks have already been created in one of your Jira applications. You can convert these sub-tasks to standard issue types if you would like to disable them. 

  1. Select the Jira icon (, or ) > Jira settings > Issues.
  2. Under ISSUE TYPES, select Sub-tasks.
  3. Click Enable or Disable sub-tasks as needed.  

How to create a sub-task issue type

  1. Select the Jira icon (, or ) > Jira settings > Issues.
  2. Under ISSUE TYPES, select Sub-tasks.
  3. Click Add sub-task issue type
  4. Enter a name and description to define the new sub-task issue type. 
  5. Click Add

How to edit a sub-task issue type

  1. Select the Jira icon (, or ) > Jira settings > Issues.
  2. Click Sub-tasks.
  3. Find the relevant sub-task issue type and click Edit.
  4. Edit the name, description, and avatar as needed and click Update

How to choose which sub-task fields display on parent issues

You can define which sub-task issue fields are displayed in the sub-tasks section of a parent issue.

  1. Choose the Jira icon (, or ) > Jira settings > System
  2. Click General configuration > Advanced settings.
  3. For the jira.table.cols.subtasks property key, edit the field values. Note that the summary field is a mandatory value and that fields will appear on parent issues in the same order you list them. Please refer to API documentation - Constant Field Values to see all constant field options.
  4. Click Update.

How to block a parent issue workflow based on a sub-task status

You can create a custom workflow with the Sub-task Blocking Condition on the workflow transitions you want to block based on a sub-task's status. This type of condition can prevent a parent issue from being resolved until all of its sub-tasks are resolved.

  1. Select the Jira icon (, or ) > Jira settings > Issues.
  2. Click Workflows.
  3. Find the relevant workflow and click Edit.
  4. Select a transition (e.g. Resolve) and click Conditions.
  5. Click Add condition.
  6. Select the Sub-task Blocking Condition and click Add.
  7. Select the sub-task statuses (e.g. Done, Resolved) and click Add.

How to delete a sub-task issue type

Before deleting a sub-task issue type, we recommend searching for all issues of that type and bulk editing them to select another existing issue type. You can then delete the original sub-task issue type without affecting existing work.

  1. Select the Jira icon (, or ) > Jira settings > Issues.
  2. Under ISSUE TYPES, select Sub-tasks.
  3. Find the relevant sub-task issue type and click Delete.
Last modified on Jul 5, 2018

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.