# Bug Report

> A note that tells the team what broke and how to make it happen again.

**Field:** Software Development  
**Category:** Testing & Quality  
**Also known as:** Bug Ticket, Defect Report, Issue Report

## Think of it like

Think of it like telling a doctor where it hurts. The clearer you are, the faster they can help.

## Definition

A bug report tells the team about something that does not work. A good one has a short title and the exact steps to make the bug happen again. It says what you expected and what actually happened. It names the device, the browser and the app version. A screenshot or a log helps even more.

## Example

Lucy writes: add a mug, add coupon SAVE10, open the cart. She expected 18, but saw 21.60, in Chrome on Windows.

## Why it matters

A bug nobody can repeat rarely gets fixed. Clear steps save hours of guessing.

## Common mistake

Writing it does not work. Without steps, the expected result and the actual one, nobody can help.

## Three principles

- **Steps to repeat.** Exact steps, one at a time.
- **Expected and actual.** Say what should and did happen.
- **Where it happened.** Device, browser and version.

## Related terms

- [Bug](https://learn.benibix.com/term/development/bug)
- [GitHub Issues](https://learn.benibix.com/term/development/github-issues)
- [Manual Testing](https://learn.benibix.com/term/development/manual-testing)
- [Regression Test](https://learn.benibix.com/term/development/regression-test)

![A bug report drawn as a card with six labelled parts. Title: Price shows tax twice with a coupon. Steps to repeat: add a mug, add coupon SAVE10, open the cart. Expected: total 18. Actual, lit up: total 21.60. Where: Chrome on Windows, version 2.4.1. Proof: a screenshot. A note says a bug someone else can repeat is a bug someone can fix.](https://learn.benibix.com/diagrams/dev3-bug-report.svg)

---

Source: https://learn.benibix.com/term/development/bug-report
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-17
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
