How-ToAug 14, 20269 min read

How to Track Bugs in Jira (2026 Guide)

Jira remains the most widely used tool for bug tracking across engineering teams. Its issue type system, custom workflows, and deep integration with CI/CD pipelines make it a natural fit for teams who need structured defect management alongside feature work.

This guide covers how to set up a dedicated bug tracking workflow in Jira that separates bugs from feature work, captures the right context, and keeps your defect backlog actionable.

Step-by-step guide

Step 1: Create a Bug issue type with custom fields

Go to Project Settings > Issue Types and ensure the "Bug" issue type is enabled. Add custom fields: Severity (Blocker, Critical, Major, Minor), Environment (Production, Staging, Dev), Steps to Reproduce (text), Expected vs Actual Behavior (text), and Affected Version (version picker). These fields ensure every bug report captures the context engineers need.

Step 2: Configure a bug-specific workflow

Create a separate workflow for bugs: Open > Triaged > In Progress > In Review > Verified > Closed. Add a "Cannot Reproduce" status for bugs that engineering cannot replicate. Add a "Won't Fix" resolution for bugs you intentionally decline. Map this workflow to the Bug issue type in your workflow scheme.

Step 3: Set up a triage board

Create a board filtered to show only Bug issue types in "Open" status. This is your triage inbox. Review this board daily or every other day. For each bug, set severity, assign priority, link to the affected epic, and move to "Triaged."

Step 4: Create bug report templates

Use Jira issue templates to standardize bug reports. Include fields for: Summary (one-line description), Steps to Reproduce (numbered list), Expected Behavior, Actual Behavior, Screenshots/Video, Browser/Device, and User Impact (how many users affected). Templates reduce back-and-forth between reporters and engineers.

Step 5: Set up automation rules

In Project Settings > Automation, create rules: auto-assign P0/Blocker bugs to the on-call engineer, auto-move bugs from Open to Triaged after severity is set, send Slack notifications for Blocker bugs, and auto-close bugs that have been in "Cannot Reproduce" for 14 days.

Step 6: Build a bug dashboard

Create a Jira dashboard with gadgets: Open Bugs by Severity (pie chart), Bug Aging (how long bugs stay open), Bugs Created vs Resolved (trend line), and Top Bug Reporters (helps identify users hitting the most issues). Review this dashboard weekly in your team sync.

Common mistakes

Mixing bugs and features in the same workflow

Bugs and features have different lifecycles. Features go through design and spec review. Bugs go through reproduction and verification. Using the same workflow for both creates bottlenecks and unclear statuses.

No severity vs priority distinction

Severity describes the technical impact (data loss, crash, cosmetic). Priority describes when to fix it. A cosmetic bug on the login page might be low severity but high priority. Track both independently.

Bug backlog growing without bounds

A backlog with 500 open bugs is noise. If a Minor bug has been open for 6 months, either fix it or close it as Won't Fix. Schedule a monthly bug backlog grooming session.

Incomplete bug reports

A bug report that says "the page is broken" wastes engineering time. Enforce templates that require steps to reproduce, expected behavior, and actual behavior. Reject reports that do not meet the minimum bar.

Tips

  • Use Jira's "Flag" feature to mark bugs that are blocking a release
  • Create a "Bug Bash" event quarterly where the whole team focuses on fixing accumulated minor bugs
  • Link bugs to the Epic or Story that introduced them for root cause tracking

How Vantage helps

Vantage connects to Jira and understands your ticket landscape. When generating PRDs, Vantage can reference open bugs related to the feature area, ensuring new specs account for known defects. Cross-project conflict detection also flags when a new feature might conflict with an open bug fix.

Frequently asked questions

Spend less time on setup, more on decisions

Vantage connects your tools and generates specs grounded in real data. Free to start.

Free to start. No credit card required.

Related reading