splitforms.com
SUPPORT · CONTACT FORM TEMPLATE

Bug Report Form (Issue Submission)

User-reported bugs are signal — but only if the report has steps-to-reproduce and a screenshot. The form forces the structure, then files the issue automatically.

1,000/mo free·no card·works on any host
form.htmlhtml32 lines
01<form action="https://splitforms.com/api/submit" method="POST">
02 <input type="hidden" name="access_key" value="YOUR_ACCESS_KEY">
03 <input type="hidden" name="subject" value="New bug report">
04
05 <label for="title">Short summary *</label>
06 <input id="title" type="text" name="title" placeholder="What went wrong?" required>
07 <label for="severity">Severity *</label>
08 <select id="severity" name="severity" required>
09 <option value="">Choose…</option>
10 <option>Critical</option>
11 <option>High</option>
12 <option>Medium</option>
13 <option>Low</option>
14 </select>
15 <label for="browser">Browser &amp; OS</label>
16 <input id="browser" type="text" name="browser" placeholder="Chrome 120 / macOS">
17 <label for="steps">Steps to reproduce *</label>
18 <textarea id="steps" name="steps" placeholder="1. Go to…
192. Click…
203. See error" required></textarea>
21 <label for="email">Your email (so we can follow up) *</label>
22 <input id="email" type="email" name="email" placeholder="you@example.com" required>
23
24 <!-- honeypot — bots fill every field -->
25 <input type="checkbox" name="botcheck" style="display:none" tabindex="-1" autocomplete="off">
26
27 <button type="submit">Send</button>
28</form>
29
30<p style="margin-top:12px;font-size:11px;color:#888;text-align:right">
31 Powered by <a href="https://splitforms.com" style="color:#888;text-decoration:none" target="_blank" rel="noopener">splitforms</a>
32</p>
1,000
submissions / mo, free
5
fields, ready to ship
5
code outputs
60s
from copy to inbox
Bug Report Form (Issue Submission) — example splitforms template with submissions inbox
§ 01Why it mattersthe qualifying-fields argument

Bug reports without reproduction steps waste hours of triage. The form structures the report — what happened, what was expected, steps to reproduce, browser / OS / device, screenshot. Screenshot upload is critical: 'the page broke' tells you nothing; a screenshot of the broken state tells you everything. Webhook the structured report into Linear or GitHub Issues so it lands as a triageable ticket, not a Slack message that scrolls away. For SaaS teams the time saved is huge — instead of a 4-message back-and-forth gathering basic context, the engineer opens the issue and starts debugging.

Screenshot upload (Pro) · webhooks into Linear / GitHub Issues / Slack.
✦ at a glance
  • Bug report · 5 fields
  • HTML, JS, React, PHP, cURL outputs
  • One POST endpoint, no SDK
  • Honeypot + classifier, no CAPTCHA
§ 02Live previewinteractive · sandboxed · no key required

See exactly what your visitors see — and you’ll receive.

Left: the rendered form, fully interactive in a sandboxed iframe. Right: the email and dashboard view that lands the moment a visitor submits.

preview · bug-report-formlocalhost:3000
✦ what you’ll see in your inbox

Every submission becomes an email plus a dashboard row. The fields below are the exact payload your form will send. Reply-to is wired to the visitor’s email so hitting reply goes back to them.

dashboard · new submission14ms · 200 OK
SUBJECT · New bug report
Short summary
Severity
Critical
Browser & OS
Steps to reproduce
Your email (so we can follow up)
maya@studio71.co

Iframe is sandboxed — submit doesn’t actually fire. Get your access key to wire it up live.

§ 03Three steps3 steps · ~60 seconds

Generate, embed, receive.

Three actions stand between you and your first lead. None of them require a backend, a database, or a CAPTCHA library.

STEP 01GENERATE

Structure the report

Required: what happened, what you expected, steps to reproduce. Optional: browser, OS, device, URL where it occurred. Most templates auto-detect browser/OS via JS so the user doesn't have to fill them.

Create your form
key=sk_live_••••••••
STEP 02EMBED

Screenshot upload

Pro file upload — drag-and-drop a screenshot or screen recording. Multi-file accepted. Image attachments arrive on the email and via webhook with signed URLs.

snippethtml
<form action="https://splitforms.com/api/submit" method="POST">
  …
</form>
STEP 03RECEIVE

Webhook into Linear / GitHub

Lands as a Linear issue or GitHub issue with the structured report as the body and the screenshot embedded. Engineer opens, reproduces, fixes — no triage thread needed.

inbox · 1 newjust now
FROM contact@yoursite.com
New bug report
Maya Iyer maya@studio71.co
Loved your last open house in Hayes — looking for similar with parking. Pre-approved through Wells Fargo.
§ 04Copy & ship5 languages · same endpoint

Five outputs. One backend.

HTML by default. Click open the language you ship in — every variant POSTs to the same /api/submit endpoint.

01HTMLform.html32 lines
<form action="https://splitforms.com/api/submit" method="POST">
  <input type="hidden" name="access_key" value="YOUR_ACCESS_KEY">
  <input type="hidden" name="subject" value="New bug report">

  <label for="title">Short summary *</label>
  <input id="title" type="text" name="title" placeholder="What went wrong?" required>
  <label for="severity">Severity *</label>
  <select id="severity" name="severity" required>
    <option value="">Choose…</option>
    <option>Critical</option>
    <option>High</option>
    <option>Medium</option>
    <option>Low</option>
  </select>
  <label for="browser">Browser &amp; OS</label>
  <input id="browser" type="text" name="browser" placeholder="Chrome 120 / macOS">
  <label for="steps">Steps to reproduce *</label>
  <textarea id="steps" name="steps" placeholder="1. Go to…
2. Click…
3. See error" required></textarea>
  <label for="email">Your email (so we can follow up) *</label>
  <input id="email" type="email" name="email" placeholder="you@example.com" required>

  <!-- honeypot — bots fill every field -->
  <input type="checkbox" name="botcheck" style="display:none" tabindex="-1" autocomplete="off">

  <button type="submit">Send</button>
</form>

<p style="margin-top:12px;font-size:11px;color:#888;text-align:right">
  Powered by <a href="https://splitforms.com" style="color:#888;text-decoration:none" target="_blank" rel="noopener">splitforms</a>
</p>
02JavaScriptform.js48 lines
<form id="lf-form">
  <label for="title">Short summary *</label>
  <input id="title" type="text" name="title" placeholder="What went wrong?" required>
  <label for="severity">Severity *</label>
  <select id="severity" name="severity" required>
    <option value="">Choose…</option>
    <option>Critical</option>
    <option>High</option>
    <option>Medium</option>
    <option>Low</option>
  </select>
  <label for="browser">Browser &amp; OS</label>
  <input id="browser" type="text" name="browser" placeholder="Chrome 120 / macOS">
  <label for="steps">Steps to reproduce *</label>
  <textarea id="steps" name="steps" placeholder="1. Go to…
2. Click…
3. See error" required></textarea>
  <label for="email">Your email (so we can follow up) *</label>
  <input id="email" type="email" name="email" placeholder="you@example.com" required>
  <button type="submit">Send</button>
</form>

<p style="margin-top:12px;font-size:11px;color:#888;text-align:right">
  Powered by <a href="https://splitforms.com" style="color:#888;text-decoration:none" target="_blank" rel="noopener">splitforms</a>
</p>

<script>
  document.getElementById('lf-form').addEventListener('submit', async (e) => {
    e.preventDefault();
    const data = new FormData(e.target);
    data.set('access_key', 'YOUR_ACCESS_KEY');
    data.set('subject', 'New bug report');

    const res = await fetch('https://splitforms.com/api/submit', {
      method: 'POST',
      body: data,
      headers: { Accept: 'application/json' },
    });

    const json = await res.json();
    if (json.success) {
      e.target.reset();
      alert('Sent!');
    } else {
      alert('Error: ' + (json.message || 'Try again'));
    }
  });
</script>
03React / Next.jsForm.tsx63 lines
'use client';

import { useState, type FormEvent } from 'react';

export default function BugForm() {
  const [status, setStatus] = useState<'idle' | 'sending' | 'sent' | 'error'>('idle');

  async function onSubmit(e: FormEvent<HTMLFormElement>) {
    e.preventDefault();
    setStatus('sending');

    const data = new FormData(e.currentTarget);
    data.set('access_key', 'YOUR_ACCESS_KEY');
    data.set('subject', 'New bug report');

    const res = await fetch('https://splitforms.com/api/submit', {
      method: 'POST',
      body: data,
      headers: { Accept: 'application/json' },
    });

    const json = await res.json();
    setStatus(json.success ? 'sent' : 'error');
    if (json.success) e.currentTarget.reset();
  }

  if (status === 'sent') return <p>Thanks — we&rsquo;ll be in touch.</p>;

  return (
    <>
    <form onSubmit={onSubmit}>
      <label htmlFor="title">Short summary *</label>
      <input id="title" type="text" name="title" placeholder="What went wrong?" required />
      <label htmlFor="severity">Severity *</label>
      <select id="severity" name="severity" required>
        <option value="">Choose…</option>
        <option>Critical</option>
        <option>High</option>
        <option>Medium</option>
        <option>Low</option>
      </select>
      <label htmlFor="browser">Browser &amp; OS</label>
      <input id="browser" type="text" name="browser" placeholder="Chrome 120 / macOS" />
      <label htmlFor="steps">Steps to reproduce *</label>
      <textarea id="steps" name="steps" placeholder="1. Go to…
2. Click…
3. See error" required />
      <label htmlFor="email">Your email (so we can follow up) *</label>
      <input id="email" type="email" name="email" placeholder="you@example.com" required />

      <button type="submit" disabled={status === 'sending'}>
        {status === 'sending' ? 'Sending…' : 'Send'}
      </button>

      {status === 'error' && <p>Something went wrong. Try again.</p>}
    </form>

      <p style={{ marginTop: 12, fontSize: 11, color: '#888', textAlign: 'right' }}>
        Powered by <a href="https://splitforms.com" target="_blank" rel="noopener" style={{ color: '#888', textDecoration: 'none' }}>splitforms</a>
      </p>
    </>
  );
}
04PHPsubmit.php28 lines
<?php
// Drop into a PHP page. Receives a form POST and proxies it to splitforms.com.
// Useful when you want to add server-side validation or rate limiting.

if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $allowed = ['title', 'severity', 'browser', 'steps', 'email'];
    $payload = ['access_key' => 'YOUR_ACCESS_KEY'];
    $payload['subject'] = 'New bug report';

    foreach ($allowed as $f) {
        if (isset($_POST[$f])) $payload[$f] = $_POST[$f];
    }

    $ch = curl_init('https://splitforms.com/api/submit');
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($payload));
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, ['Accept: application/json']);
    $response = curl_exec($ch);
    $status   = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);

    header('Content-Type: application/json');
    http_response_code($status);
    echo $response;
    exit;
}
?>
05cURLtest.sh9 lines
curl -X POST https://splitforms.com/api/submit \
  -H "Accept: application/json" \
  -d "access_key=YOUR_ACCESS_KEY" \
  -d "subject=New bug report" \
  -d "title=Jane Builder" \
  -d "severity=Critical" \
  -d "browser=Jane Builder" \
  -d "steps=Hello from cURL" \
  -d "email=jane@example.com" 

Replace YOUR_ACCESS_KEY with the key from your dashboard. That’s the only edit.

§ 06FAQ4 answered

Things people ask before they ship.

Direct answers, no marketing fluff. Missing one? Email hello@splitforms.com.

01Should I auto-detect browser / OS?
Yes — JavaScript can read navigator.userAgent and pre-fill hidden fields with browser name, version, OS, and screen size. The user doesn't see them; the engineer gets them. Saves 90% of 'what browser are you on?' replies.
02Can I integrate with Linear / GitHub / Sentry?
Yes — webhook the JSON. Linear and GitHub both accept inbound issue creation via API or Zapier. Sentry doesn't accept user-reported bugs as events but you can webhook to a Slack channel where the on-call engineer triages and creates the Sentry issue manually.
03How do I prevent abuse / spam in bug reports?
Public bug-report forms attract spam — hidden honeypot plus splitforms' classifier catches most. Require an email field; bots filling random emails get filtered by the classifier. For severe abuse, gate the form behind a logged-in user session.
04What about screen recordings — too big to upload?
Short screen recordings (10-30 seconds, MP4) are usually 5-15MB — well within the 25MB Pro limit. For longer recordings, capture a Loom / CleanShot link in the message field instead of asking for direct upload. Loom links open inline on most email clients and triage tools.
✻ ✻ ✻

Ship your bug report form (issue submission) in 60 seconds.

1,000 free submissions per month. No credit card. Copy the snippet, paste your access key, watch leads land in your inbox.

Get free access key →Browse all 60 templates →
v0.1 · founders pricing locked in · early access open