Understanding issue types in jira

Just as a project can have many different types of work, Jira uses different issue types to help identify, categorize, and report on your team’s work. We’ll cover Jira’s standard issue types below. 

  1. Tip: You can customize issue types to suit your team’s workflow.

1-WhyIssueTypes.gif

What are the issue types?

The standard issue types in Jira are story, task, bug, subtask, and epic. How do they relate to each other, and how are they used? Let’s put it into context with an example. Say we’re on a team of game developers, and we’re working on the latest AAA title. 

2-WhatAreIssueTypes.gif

Story

A story (or user story) is a feature or requirement from the user’s perspective. Stories should be defined using non-technical language so anyone involved in the project can understand. For example:

  1. Example: As a player, I want to use a joystick to control my character (or “Add joystick support”)

The player is the user of the game, and in this story, the support for an input device is required. To solve this issue, it may be necessary to assign several smaller work items to individual teammates as subtasks.

Task

Tasks are work items that are not directly related to a user requirement but still must be completed, like the upgrading of a server, the coding of a function, or even the ordering of a pizza for the team. A task contains a more detailed and technical description of the particular work item.

  1. Example: Reduce latency to improve character movement

In this case the task involves updating a core function of the game rather than a user feature. While tasks can generally be completed by one team member, they may also be broken down into individually manageable subtasks. 

Bug

O, the lamented bug. By classifying bugs as their own issue type, we can differentiate the work they require from other issues. This enables the team do things like filter by bugs in the backlog or draft reports on the number of bugs fixed per week.

  1. Example: Character sometimes moves backward when pushing the joystick forward

3-Bug.gif

Subtask

A subtask is the child of another issue, and is used to break down stories, tasks, or bugs into individually manageable pieces of work. Since they are written for the person working on the task, subtasks can be more technical than their parent issues. 

In the above story of adding support for an input device, the following subtasks may be completed by different team members:

  1. Example:
  1. [Game Designer] Map game mechanics to joystick inputs
  1. [Software Engineer] Implement input mapping for character movement
  2. [Artist] Create a visual for joystick configuration in the options menu

A subtask can only be created under a parent issue. However, each subtask has its own issue key and can be moved through boards independently. 

Epic

Finally, an epic is a parent issue that groups stories, tasks, and bugs together to capture a large, holistic body of work. As the name implies, epics usually represent a significant deliverable. In the backlog, you can filter by issues belonging to a single epic.

  1. Example: Character movement update

In this example, the epic encompasses the story of adding joystick support, as well other stories, tasks, and bugs in an overall initiative. It might look something like this:

  • Epic: Character movement update
    • Story: As a player, I want to use a joystick to control my character.
      • Subtask: [Game Designer] Map game mechanics to joystick inputs
      • Subtask: [Software Engineer] Implement input mapping for character movement
      • Subtask: [Artist] Create a visual for joystick configuration in the options menu
    • Task: Reduce latency to improve character movement
      • Subtask: [Software Engineer] Reduce server calls and move processing to client side
      • Subtask: [IT] Update SDK for engineering team
    • Bug: Character sometimes moves backward when pushing the joystick forward
      • Subtask: [Testing] Determine conditions where this behavior happens

Subtask: [Software Engineer] Update game code

4-Outstanding.gif

Knowledge check

Did you get all that? Outstanding. Now let’s put your knowledge of issue types to the test. Match each of these issues to one of the 5 issue types:

  1. Seasonal cosmetics update
  2. Santa hats in holiday skin pack are not rendering correctly
  3. As a player, I would like to customize my avatar with costumes for Halloween
  4. Add support for a new 3D model format
  5. [Artist] Design skeletal armor skin for warrior class

Answers: (1-Epic, 2-Bug, 3-Story, 4-Task, 5-Subtask)

Related resources:

61 comments

G subramanyam
Community Leader
Community Leader
Community Leaders are connectors, ambassadors, and mentors. On the online community, they serve as thought leaders, product experts, and moderators.
November 11, 2020

Hi @Christina Nelson that's a quick and easy read. Will serve as a training aid in the events or in-house trainings. I believe this article marks complete if you can add a roadmap that includes customized issue type-"Feature" and configuring the hierarchy.

Like # people like this
Taranjeet Singh
Community Leader
Community Leader
Community Leaders are connectors, ambassadors, and mentors. On the online community, they serve as thought leaders, product experts, and moderators.
December 6, 2020

@Christina Nelson This is a great article for learning basics of Jira issue types in a quicker manner. Thanks for sharing!

Like # people like this
Monika Rani
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
January 1, 2021

@Christina Nelson succinctly written.

Like # people like this
Gonchik Tsymzhitov
Community Leader
Community Leader
Community Leaders are connectors, ambassadors, and mentors. On the online community, they serve as thought leaders, product experts, and moderators.
January 2, 2021

@Christina Nelson Thank you for that article I am going to share with accountants. They will be happy as it's written so clear

Like Biswa Bijaya Samal likes this
Rajesh Viswanathan
Community Leader
Community Leader
Community Leaders are connectors, ambassadors, and mentors. On the online community, they serve as thought leaders, product experts, and moderators.
January 4, 2021

thanks for articulating the steps . 

Richard White January 18, 2021

@Christina Nelson Thanks for a very clear explanation. These have been shared with newbies to Jira. 

Claire Unwin February 22, 2021

@Christina Nelson wanted your advice on structuring a large project where multiple stories are used in different customer journeys. 

I see I can create other issue types e.g. 'user journey' for large definitions and 'feature' for small reusable pieces. Is the hierarchy of epic -> story -> task ->subtask the only hierarchy inbuilt in Jira? I know I can link any issue to any issues but that's more complex especially when it comes to reporting progress. 

Or is there a much better way to achieve a larger hierarchy?

thx

Like # people like this
karina_brito March 10, 2021

That´s Excellent, I will share this article with my colleagues. Thank you!

Khushlen Kandhari March 11, 2021

Very helpful indeed. Thanks for sharing. 

Like Biswa Bijaya Samal likes this
Priyanka Gupta March 23, 2021

Thanks for this Article good for understanding.

Bulxan Kamaal April 15, 2021

Thanks a lot for sharing wonderful article about the basics of Jira

Veronique DUFOUR April 20, 2021

Good intro!

dward April 26, 2021

As a new Jira user, this article was just what I needed. Concise and to the point. Thank you

Like # people like this
Alexander Bondarev
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
April 30, 2021

Thanks! Excellent and useful article! 🤓

luis.ortiz May 13, 2021

Thank you for the simple and straight to the point explanation.

Meri Uwi June 3, 2021

this is really helpful especially for a starter like me

mchagas
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
June 16, 2021

@Christina Nelson Very nice article for learning basics of Jira issue types! Thanks for sharing!

Brian Latimer June 22, 2021

Love this article; thanks for posting such a clear explanation!

Minor nit-pick, though: The formatting for "Subtask: [Software Engineer] Update game code" entry on this page seems it should be an indented bullet-list item, at the same level as "Subtask: [Testing] Determine conditions where this behavior happens", and should not be in italics. I'm assuming that the addition of the (excellent!) GIF of Sue Sylvester, modified the formatting for this final bullet-list entry in an unexpected manner.

Like Rajesh Viswanathan likes this
Peter Esposito July 26, 2021

Very clear, thak you for the great information.

Like Rajesh Viswanathan likes this
Bill Washinski July 30, 2021

This is a very succinct breakdown that makes it simple to understand. 

Vikrant Yadav
Community Leader
Community Leader
Community Leaders are connectors, ambassadors, and mentors. On the online community, they serve as thought leaders, product experts, and moderators.
August 3, 2021

@Christina Nelson  Very nice Article :)

Praneet Kumar September 1, 2021

Hi All -

 

What is the best way to track complex technical design work such as Integration design? This would include conducting multiple design workshops, creating mapping documents, transformation rules, etc.?

My suggestion to the team was to use Task and track effort by enabling time tracking.

An alternate recommendation was to use user story and use points which I think is wrong for various reasons.

Thoughts?

Thanks, Praneet

Like Rajesh Viswanathan likes this
Juan Pablo Torrealba September 7, 2021

Very helpful! Thanks @Christina Nelson . 

Like Rajesh Viswanathan likes this
Rahul Bhansali September 11, 2021

@Christina Nelsonthanks for putting up this post. I am a new comer to Jira and tried using the platform for one of my pilot projects , playing around on the platform. Your post has certainly added to my knowledge and assured I've been moving in right direction, here onwards my confidence will be enhanced.

Like Rajesh Viswanathan likes this
Abdelrahman ElRuby September 13, 2021

resolution for board page is now bigger and cannot revert back to original size and now i have to use scroll bar to check the rest of the board.

Like Rajesh Viswanathan likes this

Comment

Log in or Sign up to comment
TAGS
AUG Leaders

Atlassian Community Events