How to Write a Great Bug Report (2026) — Template & Examples

2026-07-17 · By Avinash Kamble, reviewed by Priyanka G.

Developers reject vague bug reports and QA loses hours re-triaging. The fix is a rigid 8-part template — every field required, no exceptions.

1. Title — action + result + context. "Checkout: 3DS challenge closes silently on Firefox 128 mobile".
2. Environment — build, OS, browser, device, user role.
3. Preconditions — logged-in user, feature flag X on, cart with 2 items.
4. Steps to reproduce — numbered, minimal, no ambiguity.
5. Expected result — the exact behaviour per spec.
6. Actual result — what happened; include screenshots/HAR.
7. Severity — impact on the user (Critical / High / Med / Low).
8. Priority — urgency for the business (P0–P3).

BEFORE
"Checkout broken, please fix"

AFTER
Title: Checkout — 3DS iframe closes after 5s on Firefox 128 mobile
Env: v2026.7.2, Firefox 128, iPhone 15 iOS 18.2
Steps: 1) Add SKU-42, 2) checkout, 3) Visa 4000-0000-0000-3220
Expected: 3DS challenge stays until submission
Actual: iframe closes after 5s, order fails with "PSP_TIMEOUT"
Severity: High (blocks checkout for 12% users)
Priority: P1

Describe the bug in plain English in the AI Bug Report Writer and it fills the template, suggests severity, and emits Jira-ready markdown.