Configuring Sub-tasks

Sub-Task issues are generally used to split up a parent issue into a number of tasks which can be assigned and tracked separately. (For details, see Creating a Sub-Task.)

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.

If Sub-Tasks are enabled and you have defined at least one Sub-Task issue type, your users will be able to:

create Sub-Tasks.
convert issues to Sub-Tasks (and vice versa).

On this page:

Disabling Sub-Tasks

Sub-tasks are enabled by default. However, this feature can be disabled from the Sub-Tasks administration page.
Sub-Tasks will be disabled by default if your JIRA installation was upgraded from a version prior to 4.2 that had Sub-Tasks disabled.

To disable Sub-Tasks:

「JIRA 管理者」グローバル権限を持つユーザーとしてログインします。
Select 'Administration' > 'Issues' > 'Issue Types' > 'Sub-Tasks' (tab) to open the 'Sub-Tasks' page.
Keyboard shortcut: 'g' + 'g' + type 'sub'
Click the 'Disable Sub-Tasks' link. The page reloads and informs you that Sub-Tasks are now disabled.

Please Note: Sub-tasks cannot be disabled if one or more Sub-Tasks exists in the system. You must remove any existing Sub-Tasks (or convert them to standard issues) before you can disable this feature.

Enabling Sub-Tasks

Sub-tasks can be enabled from the Sub-Task administration screen.

To enable Sub-Tasks:

「JIRA 管理者」グローバル権限を持つユーザーとしてログインします。
Select 'Administration' > 'Issues' > 'Issue Types' > 'Sub-Tasks' (tab) to open the 'Sub-Tasks' page.
Keyboard shortcut: 'g' + 'g' + type 'sub'
Click the 'Enable Sub-Tasks' link. The page will reload and inform you that the Sub-Tasks are now enabled.
A default Sub-Task issue type is automatically available for use. You can edit it by clicking its '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 page (described above). The Sub-Tasks administration page also allows you to create, delete, edit, translate and choose icons for your Sub-Task issue types. For details, please see Defining Issue Types.

Blocking Issue workflows by Sub-Task status

It is possible to restrict the progression of an issue through workflow depending on the status 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' status.

Configuring Sub-Task fields

You can choose which subtask fields are displayed in the 'Sub-Tasks' section of an issue, by customising JIRA's advanced configuration options.

Choosing which Sub-Task fields to display on the Parent Issue

To customise the Sub-Task columns that appear on the parent issue's View Issue screen, edit the jira.table.cols.subtasks property on JIRA's 'Advanced Settings' page.

Choosing which fields to display in the 'Add Sub-Task' form

To customise the Sub-Task 'Quick Create' form, edit the jira.subtask.quickcreateform.fields property of your jira-config.properties file.
For a list of available fields to include, see Displaying Search Results in XML.

Child pages