Skip to content

Bug report templates

5 templates

All templates

Compare bug report versions

Bug TrackerCustomer Bug Report FormDefect Triage GuideGame Bug Report
FormatSpreadsheetDocumentDocumentDocument
Works inGoogle Sheets and ExcelGoogle Docs and WordGoogle Docs and WordGoogle Docs and Word
Length3 slides6 pages7 pages8 pages
StyleBoldFriendlyModernCorporate

What a bug report should cover

A bug report describes a defect clearly enough for someone else to reproduce it and fix it. The pages in this group also cover triage, tracking and status updates during a release.

Read more

Cover summary, steps to reproduce, expected and actual results, environment and version, severity and priority, screenshots or logs, and status and owner.

Write the steps so a stranger can follow them from a clean start, and say exactly what you expected to happen.

Compare Bug Tracker, Customer Bug Report Form, and Defect Triage Guide, all 3 to 8 pages long, then pick the closest match and replace the sample text with your own.

Questions

What is a bug report?

A bug report describes a defect clearly enough for someone else to reproduce it and fix it. The pages in this group also cover triage, tracking and status updates during a release.

What should a bug report include?

Include summary, steps to reproduce, expected and actual results, environment and version, severity and priority, screenshots or logs, and status and owner. Write the steps so a stranger can follow them from a clean start, and say exactly what you expected to happen.

How do you write a good bug report?

Give a short, specific title, the steps to reproduce, the expected and actual results, and the environment. Add a screenshot or log if it helps, and keep to one bug per report.

What is bug triage?

Bug triage is the regular review where a team decides how serious each bug is, who will fix it and when. It keeps the most important bugs at the top of the queue.

What is the difference between severity and priority?

Severity describes how badly a bug affects the product, while priority describes how soon it should be fixed. A rare crash can be severe but low priority, and a typo can be high priority before a launch.

Where should I start with a bug report?

Start with Bug Tracker: Log each bug by severity and component, assign it and see how long it stays open. If that is not the right fit, compare it with Customer Bug Report Form.

How many pages does a bug report need?

The templates here are 3 to 8 pages long. Cut any section you do not need; each template explains what its sections are for.

Can I make a bug report in Google Sheets?

Yes. These bug report templates work in Google Sheets, Microsoft Excel, Google Docs, and Microsoft Word. All 5 templates are free, with no account or email needed.

Who are these bug report templates written for?

Mostly agencies and consultants. The sample text in each one is written for a specific situation, so replace it with your own details.

Preparing your template…