Formly
Back to Templates
General

Bug Report Form

Collect bug reports with reproduction steps, environment details, and screenshots: reports your developers can actually act on.

7 fields
1 page

Ready to use

Included Fields

Summarize the bug in one sentence

Short Answer

What steps led to the bug?

Long Answer

What did you expect to happen, and what happened instead?

Long Answer

How severe is it for you?

Multiple Choice

Where did it happen?

Short Answer

Screenshot or screen recording

File Upload

Your email (so we can tell you when it's fixed)

Email

Form Structure

1

Report a Bug

7 fields
Summarize the bug in one sentence
What steps led to the bug?
What did you expect to happen, and what happened instead?
How severe is it for you?
Where did it happen?
Screenshot or screen recording
Your email (so we can tell you when it's fixed)

About this template

A bug report form that asks the questions a developer would: reproduction steps, expected vs. actual behavior, severity, environment, and a screenshot, turning "it's broken" into a ticket someone can fix without a follow-up interview.

Most user bug reports fail at reproducibility, so this template makes the three reproducibility questions required: the steps, the expectation, and the reality. The severity question (phrased from the user's perspective, not engineering jargon) gives your triage a genuine urgency signal, and the optional email closes the loop, which is what turns reporters into repeat reporters.

Embed it in your app's help menu or link it from your support page. Route submissions via webhook straight into your issue tracker and the form becomes the front end of your engineering queue.

Tips for better results

  • 1Keep the one-sentence summary required; it becomes the ticket title and forces clarity.
  • 2Route 'Blocking' reports to an alerts channel via webhook; they're incidents, not backlog.
  • 3Always tell reporters when their bug ships; it's why the email field exists, and it builds a volunteer QA army.
  • 4The pre-filled placeholders (1. Go to... 2. Click...) meaningfully improve the quality of steps people write.

Frequently asked questions

How do reports get to my issue tracker?

Use webhooks to create issues automatically in your tracker or automation tool, or have your AI agent pull recent submissions and summarize them via Formly's MCP support.

Can users attach screenshots?

Yes. The file upload field accepts screenshots and screen recordings, which resolve more bugs than any written description.

Should bug reports be anonymous?

Allow it; the email field here is optional. A slightly less traceable report beats an unreported bug.

Who this template is for

  • Software teams collecting user-reported bugs
  • Beta programs channeling tester feedback
  • QA teams standardizing internal bug intake
  • Agencies collecting client-reported issues during UAT

Not an exact fit? Use this template as a starting point and edit anything, or describe what you need and let Formly's AI adapt it for you.

Create Form

Your First Form Is a Sentence Away

Describe what you need to collect. Formly builds the form, you hit publish, and the responses start flowing in.

One simple plan. Cancel anytime.