---
title: 'Product Management templates: Bug report'
teaser: A simple base to get you started with writing bug reports.
tags: templates,product management
author: Jared Turner
published_on: 2024-03-26
---

<aside class="info">
  Our ethos with <a href="https://thoughtbot.com/blog/tags/templates">templates</a> is to start simple. Every template will evolve depending on the team, industry, company size and more.<br><br>
  
  These are a tried-and-tested base that we reach for when starting a new project.
</aside>

Bugs are a unique case that don't follow the [story format]. The single most important thing in a bug report is reliable steps to reproduce the issue.

<aside class="info">
  Sometimes more detail is useful eg. priority, browser, operating system, app version, workaround etc. We suggest you start lightweight and only add more sections when you feel the pain of not having them.
</aside>

Copy and paste the below template, provided in html or markdown.

---

## Steps to reproduce

- A linear list
- of things you need to do
- to reliably reproduce the issue

{screenshot / video is an incredibly useful addition}

## What you expected to see

## What you saw instead

---

```
## Steps to reproduce

- A linear list
- of things you need to do
- to reliably reproduce the issue

{screenshot / video is an incredibly useful addition}

## What you expected to see



## What you saw instead


```

[story format]: https://thoughtbot.com/blog/product-management-templates-job-story