• Products
  • Documentation
  • Resources

Manage subtasks in team-managed projects

This page is for team-managed projects

If the lower-left of your project sidebar says you're in a company-managed project, check out these company-managed project articles instead.

Learn more about the difference between company-managed and team-managed projects.

In Jira, an issue can have subtasks that can be assigned and tracked individually. This allows you to break down the work in your project to smaller, more manageable pieces.

Learn more about converting issues into subtasks or subtasks back into issues.

Add a subtask issue type

Subtask issue types are different from regular issue types. By default, team-managed projects have subtask issue types enabled. If your project doesn’t have the subtask issue type, you’ll need to add it:

  1. Navigate to your team-managed software project.

  2. Go to Project Settings > Issue types.

  3. Select Add issue type.

  4. Select Subtask.

Create subtasks

You can create subtasks under any standard issues, like stories, bugs, or tasks. Note that you cannot create subtasks under epics or other subtasks.

When viewing an issue

  1. On the board or backlog, select an issue.

  2. Select Add a child issue

  3. Enter a description for the subtask and select Create.

Adding a child issue from the issue details.

On the board

  1. On the board of your team-managed project, next to Group by, select Subtask (project admins only).

  2. Select Create issue (+) to create a subtask under that issue.

Grouping a board by subtask.

View subtasks on the board

Note that only the project admin can access this setting.

  1. Navigate to the board in your team-managed project.

  2. In the Group by dropdown, select Subtasks. The headers for each swimlane will be your regular issues, and the cards underneath each header represent your project's subtasks. You can then move those subtasks between columns like you would any other issue.

When a parent issue is cleared, its subtasks are also cleared, regardless of each subtask’s status. This means that if a subtask belongs to a parent issue that’s been cleared from the board, the subtask won’t be visible.

Additional Help