> For the complete documentation index, see [llms.txt](https://docs.notionapps.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.notionapps.com/use-cases/bug-tracker.md).

# Bug Tracker

## Build this

Issue intake via **Create Form**, then triage on a **Board** by Status with Details + Comments.

## Notion setup

* **Bugs** — Title, Status, Severity, Reporter, Screenshots (files)
* Writable Status field for Board columns
* Optional comments on Details

## Screens to add

1. **Create Form** for intake (keep it short)
2. **Board** grouped by Status
3. **Details** with description, files, comments
4. Optional public form + private triage via mixed portal

## Build path (15–30 minutes)

1. [Types of Screens](https://docs.notionapps.com/screens-and-components/types-of-screens)
2. [Organize Create Forms](https://docs.notionapps.com/how-to-guides/organize-create-forms-with-sections-and-an-optional-stepper)
3. [Board List View](https://docs.notionapps.com/how-to-guides/board-list-view)
4. [Comments](https://docs.notionapps.com/screens-and-components/type-of-components/comments)
5. [File upload](https://docs.notionapps.com/screens-and-components/type-of-components/file-upload)

## Optional upgrades

* [Prefill Create Forms from a URL](https://docs.notionapps.com/how-to-guides/prefill-create-forms-from-a-url)
* Notify assignees — [Automation](https://docs.notionapps.com/automation)
* [Mixed portal](https://docs.notionapps.com/how-to-guides/build-a-mixed-public-private-portal)

## Common pitfalls

* Intake form asks for too much
* Board Group By not writable
* Staff triage screens visible to anonymous reporters

## Verify

1. Submit a bug from an incognito window.
2. Drag it across Board columns as staff.
3. Confirm files + comments on Details.

## Related

* [Task Tracker](https://docs.notionapps.com/use-cases/task-tracker)
* [Field Operations](https://docs.notionapps.com/use-cases/field-operations)
* [Use Cases overview](https://docs.notionapps.com/use-cases/use-cases-overview)