What a bug report includes
Ten fields make a bug report a developer can act on. Here’s what goes in each, with an example.
Bug IDA unique ID for tracking.
TitleThe problem in one line, specific and searchable.
SeverityHow badly it affects users.
PriorityHow soon it must be fixed.
EnvironmentDevice, OS, browser and build number.
Steps to reproduceNumbered steps anyone can follow.
Expected resultWhat should happen.
Actual resultWhat happens instead.
AttachmentsScreenshots, a screen recording or logs.
StatusWhere the bug is in its life cycle.
Bug report example: checkout and search
Five real-style bugs at different stages, from new to closed.
How to write a bug report developers can fix
One bug, clear steps, proof attached.
- One bug per reportSplit combined problems, so each bug can be fixed, retested and closed on its own.
- Write steps anyone can repeatStart from a known state and number every action. If a developer can’t reproduce it, it won’t get fixed.
- State expected vs actualSay what should happen and what happens instead, in plain words.
- Add the environmentDevice, OS, browser and build number: bugs often appear in only one of them.
- Attach proofA screenshot, a short screen recording or the console log saves a round of questions.
Severity vs priority
Severity is about impact. Priority is about urgency. They’re set separately.
Answers: how bad is it?
Severity
How badly the bug affects the system or users. Usually set by the tester.
Example: OTP email arrives after it expires: critical, users can’t sign in.Answers: how soon must it be fixed?
Priority
The order the team fixes bugs in, based on business need. Usually set by the product owner or lead.
Example: A typo in the homepage headline: low severity, but high priority before a launch.Stay in the loop
Get new batch dates on WhatsApp. One message when a batch opens, nothing else.
By subscribing you agree to receive WhatsApp messages from Tester Academy. Read our Privacy policy.

