How to Track Bugs in Linear (2026 Guide)
Linear's speed and opinionated workflows make it a strong choice for bug tracking. Unlike Jira, Linear does not use separate issue types for bugs. Instead, you use labels and triage to separate defects from feature work while keeping everything in a single fast interface.
This guide covers how to build an effective bug tracking system in Linear using labels, triage, views, and automations.
Step-by-step guide
Step 1: Create a Bug label group
Go to Team Settings > Labels and create a label group called "Type" with labels: Bug, Feature, Improvement, Chore. Create a second group called "Severity" with labels: Sev-0 (outage), Sev-1 (major broken flow), Sev-2 (degraded experience), Sev-3 (cosmetic). Apply these labels consistently to every issue.
Step 2: Enable and configure Triage
Enable Triage in Team Settings. All new issues, including bugs reported via Slack or email, land in Triage first. During daily triage, label each issue as Bug/Feature/etc., set severity and priority, and accept or decline. This prevents unvetted bugs from polluting your backlog.
Step 3: Create a Bugs view
Create a saved view filtered to Label = Bug. Group by Priority. This gives you a dedicated bug board showing Urgent, High, Medium, and Low bugs. Pin this view to your sidebar for quick access during standups.
Step 4: Set up SLA automations
In Team Settings > Automations, create rules: auto-assign Sev-0 bugs to the on-call engineer, move Sev-0 bugs to "In Progress" immediately, send a Slack notification to #engineering for any Sev-0 or Sev-1 bug. Use Linear's SLA feature to set response time targets per severity level.
Step 5: Link bugs to projects and cycles
Assign bugs to the relevant Linear Project so they appear alongside the feature work they affect. Add Sev-0 and Sev-1 bugs to the current Cycle so they are visible in sprint planning. Lower severity bugs can remain in the backlog until explicitly pulled in.
Step 6: Track bug metrics
Use Linear's analytics to monitor: bugs created per week, mean time to resolve by severity, bugs per project area, and triage-to-resolution time. Review these metrics monthly to spot quality trends.
Common mistakes
Skipping Triage for bugs
Letting bugs bypass Triage means anyone can add bugs directly to the backlog without vetting. This leads to duplicates, incomplete reports, and backlog bloat. Triage every bug, even urgent ones.
Not using severity labels
Without severity labels, all bugs look equally important. A cosmetic alignment issue and a data corruption bug should not have the same urgency. Severity labels create an objective framework for prioritization.
Letting old bugs accumulate
Bugs older than 90 days that have not been prioritized are unlikely to ever be fixed. Archive them. If they matter, they will be re-reported. A clean backlog is a useful backlog.
Tips
- Use Linear's Slack integration to let anyone report bugs directly from Slack messages
- Create a "Bug Duty" rotation where one engineer handles all new bug triage each week
- Use Sub-Issues to break complex bugs into investigation and fix tasks
How Vantage helps
Vantage syncs bi-directionally with Linear. When you generate tickets from a PRD in Vantage, they push to Linear with full context. When bugs are filed in Linear against a feature area, Vantage surfaces them as context during future PRD generation, so new specs account for known issues.