Skip to main content

3 min read

Improve your Jira structure with an epic>story>task hierarchy

Two men on a ladder stacking giant blocks on top of each other

Learn how to configure an epic>story>task hierarchy in Jira

Jira is an incredibly powerful tool, but there are times when users struggle with limitations to its native functionality. This is especially true of Jira’s in-built hierarchy. Luckily, there are ways to create a custom issue hierarchy and produce more detailed reports, but not all solutions are made equal. Find out more about configuring different hierarchy levels in Jira.

copy_text Icon
Copied!

The problem with sub-tasks in Jira

By default, Jira supports an issue type hierarchy of epic>story>sub-task. The problem with this is that you can't add sub-tasks to sprints like you can with stories, tasks, bugs, and other base layer issue types.

Without sprints, you lose access to a range of built-in reports designed to help manage your projects. Jira provides burndown charts, burnup charts, sprint reports, velocity charts, and version reports, many of which require sprints for data. Although some teams may not need to batch their work into sprints, for others this functionality loss is a deal-breaker. 

To overcome this and access Jira’s built-in reports when using this hierarchy type, teams can still use sprints and simply add higher-level stories instead of lower-level sub-tasks. This works well if stories are small and only contain two or three sub-tasks.

copy_text Icon
Copied!
List of child issues within a Jira story

However, for teams with large stories and many sub-tasks, work may not fit into a single sprint. Even if it does, Jira’s built-in reports won’t be as useful. Rather than being updated whenever a sub-task is resolved, the report will only update when the entire story is complete, making reports patchy and inconsistent, tracking less accurate, and forecasts less valuable.

copy_text Icon
Copied!

Why you shouldn’t use epics as stories

Taking another approach with your hierarchy, you could use Jira cloud Premium and create levels above epics, leading to a feature>epic>story hierarchy.

copy_text Icon
Copied!
Screenshot of a project within Jira

With this issue hierarchy, everything moves up a level. What would’ve been a story is now an epic and what would’ve been an epic is now a feature. Since stories are now the lowest-level issue type, all work can be added to sprints, and you can use Jira’s built-in reports to track your project accurately.

So what’s the problem? The first limitation is that Jira cloud Premium costs US$10 per user. This can be a steep price to pay to use a more comprehensive issue hierarchy. 

The second limitation is that you can’t add epics to sprints. This means you must break down every epic into stories—but some epics might not need to be broken down further. This creates extra work, which can be confusing as well as inconvenient.

copy_text Icon
Copied!

How the epic>story>task hierarchy can solve all your problems

An epic>story>task (or epic>story>task>sub-task) hierarchy has two levels which can be added to sprints: stories and tasks.

copy_text Icon
Copied!
A list of sprints in Jira with different details

This gives you the flexibility to add stories directly to sprints, or further break down stories into several tasks to add to sprints.

copy_text Icon
Copied!
Benefits table

This can work for many teams without an external add-on.

copy_text Icon
Copied!

How to add a task to a story in Jira

Adding a task to a story under the epic>story>task hierarchy can be fiddly. One way is to use issues to link a task to a story natively in Jira; however, Jira won’t know you’re trying to create a hierarchy.

A simpler way is by using an add-on. Hierarchy for Jira lets you create a completely custom issue hierarchy, so you can create levels both above epics and below stories. This makes it easy to create an epic>story>task>sub-task hierarchy and easily link task to stories (or any issues to each other in a parent-child relationship). With this method, you retain the use of Jira’s built-in reports AND you get a handy tree view of your Jira issue hierarchy.

copy_text Icon
Copied!
Textbox within Jira with arrow pointing to words "child of"

Try out a new Jira hierarchy for your next project

The epic>story>task hierarchy is an underrated way to structure your projects in Jira. With it, you can add issues to sprints over two different levels and retain the use of Jira’s built-in reports. Try it out right now—entirely for free. Click below to get started.

Try now for free
copy_text Icon
Copied!

About the authors

Wilson Ong

Wilson Ong

Wilson is the Product Marketing Manager for Hierarchy for Jira at Adaptavist. With a deep passion for being the voice of the customer and understanding market trends, he thrives on discovering new and innovative use cases for Hierarchy for Jira, empowering users and ensuring their success with our app.