Jira issue types

Simplify project work by categorizing and tracking tasks using Jira issue types and hierarchies to uncover trends and prioritize work.

A Jira issue is the atomic unit of work inside Jira — one task, one bug, one request — and the issue *type* is how you label what kind of work it is. Get the types right and the rest of Jira starts to behave: reports make sense, hierarchies hold together, and teams stop arguing about whether a thing is a story or a task.

This is a working guide to the standard issue types, how parent/child relationships and Jira's hierarchy fit together, what an issue actually contains, and where custom types earn their keep.

What is an issue in Jira?

An issue in Jira represents a single task or activity a developer or team needs to complete — a project assignment, a helpdesk ticket, a request form. Each issue captures the information that makes work trackable: assignee, description, status, affected systems. That data pays off in three places:

  • Transparency: Teams that track issues consistently develop a shared picture of the work they take on, which improves communication and hand-offs.

  • Prioritization: Ranking issue types helps teams surface critical work and improve both throughput and quality.

  • Reporting: Project managers use issues as concrete evidence of progress for stakeholders — showing what kind of work the team does, how often, and where the trends point.

Jira issue types

Jira ships with a handful of standard issue types that cover most work. These are the ones you'll see across almost every project:

  • Epics: A collection of related issues grouped under a shared objective. Epics can contain stories, tasks, or bugs.

  • Stories: Used in agile development to describe a feature from the user's point of view.

  • Tasks: A catch-all for work that doesn't fit neatly into another type.

  • Bugs: A defect or error that needs fixing.

  • Subtasks: Smaller units of work broken out of a larger issue, sometimes called child issues.

Custom issue types

Administrators can extend the default list with custom types tailored to how a team works. The available types also depend on the Jira product in use — Software, Service Management, or Work Management. Common custom types include:

  • Change

  • IT help

  • Incident

  • New feature

  • Problem

  • Service request

  • Support

  • Improvement

  • Test case

  • Spike

  • Technical debt

  • Research

Parent and child issue relationships

Jira uses "parent" and "child" to describe dependencies between issues.

  • Parent: An issue that contains subtasks. Delivery of the parent depends on the children being completed.

  • Children: The subtasks that roll up to a parent issue.

If the parent task is to build a new website, the children might include:

  • Wireframe development

  • Graphic design

  • Backend programming

  • Copywriting

Each child has to close for the parent to close.

The parent/child pattern isn't limited to standard types — any issue can have a child, including bugs with sub-bugs. The one exception is subtasks: they can't become parents, since nothing sits below them in the hierarchy.

Understanding Jira issue hierarchy

The parent/child link is one way issues relate; Jira's built-in hierarchy is another. The hierarchy defines where each piece of work sits in the overall scope of a project.

Jira's native hierarchy has three levels, from top to bottom:

1. Epics: Broad objectives that require completing many tasks, stories, or bugs. 1. Issues: Stories and tasks that support the epic. Bugs live here too — errors that need to be fixed before the epic can ship. 1. Subtasks: The smallest units of work, which make up stories, tasks, and bugs.

Anatomy of a Jira issue

A Jira issue can hold a lot of information, including:

  • Assignee

  • Due date

  • Status

  • Category

  • Priority

Jira stores this data in individual issue fields. Some are standard; others are custom fields created by an administrator. Every field feeds reporting and tracking downstream.

Choosing the right fields matters more than most teams realize: When the information a team needs is present on the issue, work flows in the right order and productivity climbs. When it isn't, people ask the same questions again in Slack.

Once you've decided what information to capture, the issue layout is straightforward to configure. Atlassian splits the Jira issue page into five standard regions that admins can arrange from the browser.

The standard regions on a Jira issue page are:

1. Description

The first place developers look for information. Best practice is to put the most important context here.

2. Field tabs

Located at the top of the issue view. Admins use them to organize data relevant to different groups on the project team.

3. Context fields

When an admin creates a custom field, Jira assigns it a context field that can be pinned above the "Details" box. Context lets the admin set default language and value and scope the field to specific issue types or projects.

4. More fields

The "More fields" area sits below the "Details" panel and holds supporting information that doesn't drive workflow. Empty fields here are hidden from view.

5. Configure issue layout

The "Configure" button lets admins rearrange the page and toggle field visibility, so the most important information stays in front of the people doing the work.

Managing Jira issue types with Tempo

Tempo offers a set of applications for teams that need more from Jira issues than Jira ships with out of the box. Gantt Charts for Structure PPM uses real-time automation to keep project plans and roadmap visualizations aligned as issues change.

Timesheets brings time tracking and capacity management directly into Jira, logging and reporting on issue data with a few clicks and surfacing productivity through burn-up charts and time-per-issue reports.

Timesheets pairs with Financial Manager, which monitors projects, epics, and portfolios to give real-time visibility into cost, budget, and profit — and to make trends visible across the organization.

Structure PPM

Align your entire organization

Manage products, projects, and programs in a single spreadsheet-like view. By providing a clear, real-time view of project progress and resource allocation, Structure helps teams meet deadlines and adapt swiftly to changing priorities.

Start a Free Trial

Frequently Asked Questions

Couldn't find what you need?Go to our documentation

From the Jira browser interface, click 

Administration > Issues > Issues Type

On the Issue Type page, hover over the “Edit” operation link to display the issue type’s ID in the browser’s status bar. It will look like this:

http://<your-jira-server>/secure/admin/EditIssueType!default.jspa?id=<ISSUE_TYPE_ID>

To add a new category to the list view, the administrator must do the following:

1. Navigate to the project’s list view

2. Choose the cell in the “Issue” row that they wish to categorize under the list’s “Category” field

3. Type the name of the category

4. Click “Enter”

The new category appears in the selected field.

If the administrator wishes to add an existing category to an issue, they can do this:

1. Open the project’s list view

2. Select the cell in the row of issues under the “Category” field they wish to categorize

3. Select an existing project issue category

4. Click “Enter”

Related articles

Learn about different levels within the Jira hierarchy and how to leverage them to prioritize tasks, improve productivity, and monitor progress.

Build swimlane roadmaps in Jira with Structure PPM. Group epics into lanes by team, theme, or sequence – without exporting data.

Explore More Content

Powered by Structure’s custom hierarchies, visualize your roadmap, project plans, timeline & dependencies within Jira Gantt charts

Portfolio Manager integrates seamlessly with Jira to give you predictive scheduling, real-time scenario modeling, and advanced resource management – ensuring you stay on track, no matter what challenges arise.

For planning leaders looking to add a big-picture roadmap view to their structured Jira data, this integration is essential. Improve visibility to leadership, reduce reporting admin, and keep your team aligned.

Combining Tempo Timesheets and Structure PPM provides a unified view of time tracking and project progress, enabling more accurate reporting and effective portfolio management. Simplify workflows, enhance collaboration, and ensure projects stay on time and within budget.

Capture human time and AI activity together in Jira so you can measure what your AI tools are truly contributing and costing.

Extend your Jira with prebuilt and highly configurable reports for straightforward time tracking.

Visualize all your Jira data & manage portfolios of projects in real-time.

Colleagues interacting around a desk

Effortlessly bridge Jira with your preferred BI tool, unlocking unparalleled insights and enhancing decision-making

See how work is progressing and where blockers are with the most flexible reporting app in Jira.

#1 Jira Time Tracking & AI Apps: Log Tempo Timesheets for Planning, Project Management & Billing. Plugin Office365, Google & Slack

Seamlessly manage project timelines and resources while accurately tracking time spent on tasks. This integration enhances visibility, improves planning accuracy, and supports data-driven decision-making for better overall project outcomes.

Integrate Jira with Google BigQuery to seamlessly export and sync data for advanced analytics and customized reporting

Connect AI spend to the work it delivers. Attribute AI coding-tool costs to Jira epics and prove AI ROI, inside Jira with Tempo Workforce Intelligence.

Gain a more complete project management solution, simplifying project reporting, improving collaboration, and ensuring projects stay on time and within budget.

Build and scale a custom ITSM solution at your own pace with Tempo's modular suite of integrated tools. Enhance Jira's capabilities and take control of your entire IT portfolio.

Modern modular PPM solutions that scale with your business. Align your teams with the integrated platform that bridges the gap between strategy and execution.

Project financial management for Jira & Timesheets. Monitor project costs, expenses, revenue, billing & budgets. Track Capex/Opex

Seamlessly connect ServiceNow with Power BI, transforming complex enterprise data into actionable insights and driving smarter, data-informed decisions across the organization

#1 Jira Resource Management App: Optimize team allocation, skillset utilization, capacity planning & project management

A powerful team resource management tool designed to optimize capacity planning and project management in Jira

Adapt to changing business needs, rapidly adjust plans, and reallocate investment.

Monitor projects and portfolios to get simple, clear, and real-time views of your costs, budgets, and profits that can be shared throughout your entire organization.

Jira Project Portfolio Management (PPM): Visualize data and manage projects within spreadsheet-like tables — in less than a minute

Tempo’s intuitive automation and Jira-native design make it the most trusted time tracking tool for enterprise organization.