Documentation for JIRA 4.0. Documentation for other versions of JIRA is available too.

Skip to end of metadata
Go to start of metadata

Sub-task issues are generally used to split up a parent issue into a number of tasks which can be assigned and tracked separately.

Sub-tasks have all the same fields as standard issues, although note that their 'issue type' must be one of the sub-task issue types (see below) rather than one of the standard issue types.

Once you have enabled sub-tasks and defined at least one sub-task issue type, users will be able to:

On this page:

Enabling sub-tasks

Sub-tasks are disabled by default. To enable sub-tasks:

  1. Log in as a user with the 'JIRA Administrators' global permission.
  2. Bring up the administration page by clicking either the 'Administration' link on the top bar or the title of the Administration box on the dashboard.
  3. Locate the 'Global Settings' sub-menu on the left hand side of the screen, and choose Sub-Tasks from the list.
  4. The 'Sub-Tasks' administration screen will be displayed. Click the 'Enable' link.
  5. The page will reload and inform you that the sub-tasks are now enabled. A default JIRADOC:sub-task issue type has also been automatically created. You can edit it by selecting the Edit link in the Operations column.

Defining sub-task issue types

Sub-tasks must be assigned one of the sub-task issue types, which are different to standard issue types. Please note that you must define at least one sub-task issue type before users can create sub-tasks.

Sub-task issue types can be customised on the 'Sub-Tasks' administration screen (which is described above). The 'Sub-Tasks' administration screen allows you to create, delete, edit, translate and choose icons for your sub-task issue types. For details, please see ' Defining Issue Types '.

Configuring sub-tasks and workflow

It is possible to restrict the progression of an issue through workflow depending on the state of the issue's sub-tasks. For example, you might need to restrict an issue from being resolved until all of its sub-tasks are resolved. To achieve this, you would create a custom workflow and use the Sub-Task Blocking Condition on the workflow transitions that are to be restricted by the sub-tasks' state.

Configuring sub-task fields

You can choose which subtask fields are displayed in the 'Sub-Tasks' section of an issue (see Working with sub-tasks '), i.e.:

  • the parent's 'View Issue' screen.
  • the sub-task 'Quick Create' form.

This is done via the jira-application.properties file.

Disabling sub-tasks

Sub-tasks are disabled from the sub-task administration screen. To disable sub-tasks please follow the following steps:

  1. Log in as a user with the 'JIRA Administrators' global permission.
  2. Bring up the administration page by clicking either the 'Administration' link on the top bar or the title of the Administration box on the dashboard.
  3. Open the Global Settings sub-menu on the left hand side if it is not open already, and choose Sub-Tasks from the list.
  4. After the Sub-Tasks administration screen loads please click the "Disable" link. The page should reload and inform you that the sub-tasks are now disabled.

    Note

    Icon

    Sub-tasks cannot be disabled if one or more sub-tasks exist in the system. You will need to remove the existing sub-tasks (or convert them to standard issues) before disabling this feature.