Tempo logotype

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.

Tags

  • Structure PPM

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
Special Offer

Frequently Asked Questions

Couldn't find what you need?Go to ourDocumentation

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”

Explore More Content

Industry-leading project plan and roadmap visualizations with a Gantt chart extension

Gantt Charts for Structure PPM

Visualize project plans and roadmaps with a Gantt chart extension for Jira

Learn more

Centralize real-time plans in one view

Structure and Gantt Charts

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

Learn more

Align strategy and execution

Structure PPM and Strategic Roadmaps

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.

Learn more

No-code Tableau Jira integration

Tableau Connector for Jira

Effortlessly bridge Jira with Tableau, unlocking unparalleled insights and enhancing decision-making

Learn more

No-code BigQuery Jira integration

BigQuery Connector for Jira

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

Learn more

Agile at Scale Software

Agile at Scale

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

Learn more

No-code Power BI ServiceNow integration

Power BI Connector for ServiceNow

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

Learn more

No more reporting limitations

Custom Charts for Confluence

Create and share all kinds of highly visual and customizable charts directly on your Confluence pages.

Learn more

Strategic portfolio management for PMO leaders

Strategic portfolio management for PMO leaders

Tempo gives PMO directors and portfolio managers the tools to reduce delivery friction, align teams, and drive measurable outcomes.

Learn more

Never lose track of a brilliant idea again

Idea Manager for Strategic Roadmaps

Never lose a brilliant idea again. Idea Manager for Strategic Roadmaps has built-in best practices to help.

Learn more
Colleagues interacting around a desk

No-Code Power BI Jira Integration

Power BI Connector for Jira

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

Learn more

Time Tracking Software for Jira

Timesheets

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

Learn more

Timesheets and Capacity Planner Integration for Jira

Timesheets and Capacity Planner

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.

Learn more

Real-time collaboration and capacity planning in Jira

Capacity Planner

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

Learn more

Timesheets and Structure PPM Integration for Jira

Timesheets and Structure

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.

Learn more

Jira Team & Resource Management

Capacity Planner

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

Go to marketplace

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

Go to marketplace

Ensure compliance and optimize spending

Governance and auditing

Portfolio governance and auditing excellence

Learn more

Strategic Portfolio Management

Strategic Portfolio Management

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

Learn more

Monitor financial health at every level

Financial Manager

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.

Learn more

Custom charts and dashboards for Jira

Custom Charts for Jira

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

Learn more

Get the data you need to succeed

Time Tracker

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

Learn more

Professional Services Automation Software for Jira

Professional Services Automation

Leverage Tempo to manage time, talent, and finances seamlessly within Jira.

Learn more

Roadmapping software for teams of all sizes

Strategic Roadmaps (Roadmunk)

The roadmapping tool designed for high-performing teams delivering boardroom-ready strategic roadmaps.

Learn more
Team working together at board with sticky notes

No-code Power BI monday.com integration

Power BI Connector for monday.com

Get powerful data export capabilities and connect monday.com to Power BI effortlessly

Learn more

Take control of your projects

Portfolio Manager and Jira

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.

Learn more

Jira Portfolio Management PPM

Structure by Tempo

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

Go to marketplace

Jira Project Cost Tracking

Financial Manager

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

Go to marketplace

Jira Time Tracking

Timesheets by Tempo

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

Go to marketplace

Jira ITSM Solutions with Tempo

ITSM

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.

Learn more

Align your organization with proactive portfolio management

Portfolio Manager (LiquidPlanner)

Predictive scheduling and the ability to forecast project timelines and spot risks so you can meet deadlines with confidence.

Learn more

Project and program management for Jira

Structure PPM

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

Learn more

AI tools are in every sprint. The data to govern them is not.

AI attribution in Jira

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

Learn more