Bug Report Vorlage: kostenlos für Jira, GitHub und Linear
Kostenlose Bug Report Vorlage zum Kopieren, fertige Versionen für GitHub, Linear und Jira, ein GitHub Issue-Formular und ein ausgefülltes Beispiel.
Eine Bug Report Vorlage ist ein fester Satz an Feldern, der dafür sorgt, dass jeder Report dieselben Fragen beantwortet: Was ist schiefgelaufen, wo, wie lässt es sich nachstellen, was hätte passieren sollen, und welche Belege zeigen es? Die Vorlage unten umfasst Titel, Zusammenfassung, Umgebung, Schritte zum Reproduzieren, erwartetes und tatsächliches Ergebnis, Häufigkeit, Schweregrad, Anhänge und Logs. Kopier sie in deinen Issue Tracker, ein Support-Formular oder eine Chatnachricht und füll die Lücken aus. Weiter unten findest du fertige Versionen für GitHub, Linear und Jira, einschließlich eines GitHub Issue-Formulars.
Vorlagen gibt es, weil Entwickler die meiste Zeit mit fehlenden Details verlieren, nicht mit dem Fix. Ein Report mit genauen Schritten, der Browserversion und dem Konsolenfehler lässt sich oft noch am selben Tag beheben. Ein Report, in dem nur „Checkout ist kaputt“ steht, wird zu einem langen Thread voller Rückfragen.
Die Vorlage
Titel: [Was kaputt ist], wenn [Aktion] auf [Seite oder Funktion]
Zusammenfassung
Ein oder zwei Sätze in einfacher Sprache. Was ist passiert, und wer ist betroffen?
Umgebung
- URL:
- Browser und Version:
- Betriebssystem:
- Gerät / Bildschirmgröße:
- App-Version oder Build (falls bekannt):
- Account / Rolle / Testnutzer:
- Datum und Uhrzeit des Fehlers (mit Zeitzone):
Schritte zum Reproduzieren
1.
2.
3.
Erwartetes Ergebnis
Was hätte passieren sollen.
Tatsächliches Ergebnis
Was stattdessen passiert ist. Mit der genauen Fehlermeldung, als Text kopiert.
Häufigkeit
Immer / Manchmal (etwa X von Y Versuchen) / Einmal aufgetreten
Schweregrad
Blocker / Schwer / Leicht / Kosmetisch
Workaround
Ein Weg, das Problem zu umgehen, oder „Keiner gefunden“.
Anhänge
- Screenshot oder Bildschirmaufnahme:
- Konsolenfehler:
- Fehlgeschlagener Netzwerk-Request (URL, Status, Response):
- HAR-Datei (bereinigt), falls angefragt:
Notizen
Alles Weitere: seit wann es auftritt, was sich zuletzt geändert hat, verwandte Tickets.
So füllst du die einzelnen Felder aus
Titel
Den Titel überfliegen die Leute in einer Liste mit fünfzig Tickets, also mach ihn konkret. Ein nützliches Muster ist „was kaputt ist“ plus „wann“ plus „wo“. „Bezahlen-Button bleibt nach Eingabe einer gültigen Karte im Checkout deaktiviert“ schlägt „Checkout-Bug“. Vermeide Wörter wie „dringend“ oder „kaputt“ für sich allein; das transportiert das Feld für den Schweregrad.
Zusammenfassung
Ein oder zwei Sätze, die auch ein nicht technischer Kollege versteht. Sag, wer betroffen ist, wenn du es weißt: alle Nutzer, nur Admins, nur Safari-Nutzer, nur ein bestimmter Kunde.
Umgebung
Viele Bugs hängen vom Browser, vom Gerät, vom Account oder von den Daten ab. Notier die genaue URL, Name und Version des Browsers, das Betriebssystem und den Account oder die Rolle, mit der du unterwegs warst. Zeigt die App eine Version oder Build-Nummer an, gib sie mit an. Der Zeitpunkt des Fehlers samt Zeitzone hilft dem Entwickler, die passenden Einträge in den Server-Logs zu finden.
Schritte zum Reproduzieren
Das ist das wichtigste Feld. Nummeriere die Schritte, starte bei einem bekannten Zustand („angemeldet als Nutzer mit leerem Warenkorb“) und gib die genauen Daten an, die du verwendet hast. Schreib eine Aktion pro Schritt. Konntest du den Fehler kein zweites Mal auslösen, sag das und beschreib so genau wie möglich, was du beim ersten Mal getan hast.
Erwartetes und tatsächliches Ergebnis
Stell beide nebeneinander, damit die Abweichung sofort ins Auge fällt. Kopier Fehlermeldungen als Text, statt sie sinngemäß wiederzugeben; der Entwickler sucht genau nach diesem String im Code. „Nichts passiert“ ist ein gültiges tatsächliches Ergebnis, aber ergänze, was du geprüft hast, etwa „keine Fehlermeldung, der Button bleibt aktiv“.
Häufigkeit
Bugs, die „immer“ auftreten, sind am leichtesten zu beheben. Bugs, die nur „manchmal“ auftreten, brauchen mehr Daten. Schätz also die Quote („3 von 10 Versuchen“) und notier alles, was eine Rolle zu spielen scheint, etwa eine langsame Verbindung oder eine große Datei.
Schweregrad
Beim Schweregrad geht es um die Auswirkung, nicht darum, wie sehr dich der Bug nervt. Eine gängige Skala:
| Schweregrad | Bedeutung | Beispiel |
|---|---|---|
| Blocker | Kern-Flow unmöglich, kein Workaround | Niemand kann sich anmelden |
| Schwer | Wichtige Funktion kaputt oder Daten falsch, Workaround ist mühsam | Rechnungen zeigen die falsche Summe |
| Leicht | Funktion geht, aber mit kleinem Problem oder einfachem Workaround | Sortierung wird nach Neuladen der Seite zurückgesetzt |
| Kosmetisch | Optisches Problem ohne funktionale Auswirkung | Button-Text überlappt auf kleinen Bildschirmen |
Die Priorität, also wann der Bug behoben wird, legt meist das Team fest, dem das Backlog gehört, nicht die Person, die ihn meldet.
Workaround
Ein Workaround zeigt dem Team, wie dringend der Fix ist, und hilft dem Support, Kunden in der Zwischenzeit zu antworten.
Anhänge und Logs
Belege sparen am meisten Zeit. Häng einen Screenshot an, auf dem die Problemstelle markiert ist, oder eine kurze Bildschirmaufnahme, die die Schritte zeigt. Bei Web-Apps gehören die Konsolenfehler und der fehlgeschlagene Netzwerk-Request dazu. Unsere Anleitungen zum Exportieren von Konsolen-Logs in Chrome und zum Aufzeichnen von Netzwerkverkehr in Chrome zeigen, wie das geht. Fragt jemand nach einer HAR-Datei, folge der Anleitung So bekommst du eine HAR-Datei und bereinige sie vorher mit dem HAR Sanitizer, denn HAR-Dateien enthalten Cookies und Tokens.
Ein ausgefülltes Beispiel
Titel: Bezahlen-Button bleibt nach Eingabe einer gültigen Karte im Checkout deaktiviert
Zusammenfassung
Auf der Checkout-Seite wird der Bezahlen-Button nach Eingabe einer gültigen
Testkarte nie klickbar, die Bestellung lässt sich also nicht abschließen.
Beobachtet in Chrome und Edge.
Umgebung
- URL: https://staging.example.com/checkout
- Browser und Version: Chrome 154 unter Windows 11; ebenso Edge 154
- Gerät / Bildschirmgröße: Laptop, 1920x1080
- App-Version oder Build: web 4.18.0 (Footer)
- Account / Rolle / Testnutzer: [email protected], Standardkunde
- Datum und Uhrzeit: 2026-11-10 14:32 MEZ
Schritte zum Reproduzieren
1. Als [email protected] anmelden.
2. „Starter-Tarif, jährlich“ in den Warenkorb legen.
3. /checkout aufrufen.
4. Testkarte 4242 4242 4242 4242 eingeben, Ablauf 12/30, CVC 123.
5. Außerhalb des Kartenfelds klicken.
Erwartetes Ergebnis
Der Bezahlen-Button wird aktiv und zeigt „120,00 $ bezahlen“.
Tatsächliches Ergebnis
Der Bezahlen-Button bleibt grau und deaktiviert. Es erscheint keine Fehlermeldung.
Die Konsole zeigt: Uncaught TypeError: Cannot read properties of
undefined (reading 'postalCode') at validateCard (checkout.js:214)
Häufigkeit
Immer (5 von 5 Versuchen)
Schweregrad
Blocker: Kunden können nicht bezahlen
Workaround
Keiner gefunden. Funktioniert im Produktions-Build 4.17.2.
Anhänge
- Bildschirmaufnahme: Link in den Kommentaren
- Konsolenfehler: checkout-console.log
- Netzwerk: POST /api/cart/validate lieferte 200; keine weiteren Fehler
Notizen
Tritt seit dem Staging-Deploy heute Morgen auf.
Achte darauf, warum dieses Beispiel funktioniert. Die Schritte beginnen mit einem bekannten Account. Die Testkarte ist genannt. Der Konsolenfehler ist wörtlich zitiert. Die meldende Person hat einen anderen Browser und den vorherigen Build geprüft, was die Ursache schon auf die letzte Änderung eingrenzt.
Kürzere Varianten
Nicht jeder Bug braucht jedes Feld. Für eine schnelle Nachricht im Team-Chat reicht eine kompakte Version:
Bug: [Titel]
Wo: [URL], [Browser/Betriebssystem]
Schritte: 1) ... 2) ... 3) ...
Erwartet: ...
Tatsächlich: ...
Beleg: [Screenshot / Aufnahme / Konsolenfehler]
Support-Teams, die den Report eines Nutzers weiterleiten, ergänzen die Account-ID des Kunden, den Link zum Ticket und die Worte des Kunden selbst und markieren, welche Teile sie selbst nachgestellt haben.
Bei QA-Testläufen kommen die ID des Testfalls und der getestete Build dazu, damit der Bug auf den Test zurückverweist, der ihn gefunden hat.
Vorlagen für GitHub, Linear und Jira
Die reine Textvorlage funktioniert überall. Stellt dein Tracker Markdown dar, bleiben Überschriften und Checklisten mit dieser Version gut lesbar:
## Zusammenfassung
<!-- Ein oder zwei Sätze: Was ist passiert, und wer ist betroffen? -->
## Umgebung
- URL:
- Browser und Version:
- Betriebssystem:
- App-Version oder Build:
- Account / Rolle:
## Schritte zum Reproduzieren
1.
2.
3.
## Erwartetes Ergebnis
## Tatsächliches Ergebnis
<!-- Füge die genaue Fehlermeldung als Text ein. -->
## Häufigkeit
<!-- Immer / Manchmal (X von Y) / Einmal -->
## Schweregrad
<!-- Blocker / Schwer / Leicht / Kosmetisch -->
## Belege
- [ ] Screenshot oder Bildschirmaufnahme
- [ ] Konsolenfehler
- [ ] Fehlgeschlagener Netzwerk-Request
GitHub Issues
Speichere die Markdown-Version als .github/ISSUE_TEMPLATE/bug_report.md in deinem Repository, mit einem kurzen Header, damit GitHub sie in der Auswahl unter „New issue“ anbietet:
---
name: Bug Report
about: Etwas ist kaputt
labels: bug
---
GitHub unterstützt außerdem Issue-Formulare, die aus der Vorlage beschriftete Felder machen, die niemand überspringen kann. Speichere das hier als .github/ISSUE_TEMPLATE/bug_report.yml:
name: Bug Report
description: Etwas ist kaputt
labels: ["bug"]
body:
- type: textarea
id: summary
attributes:
label: Zusammenfassung
description: Was ist passiert, und wer ist betroffen?
validations:
required: true
- type: input
id: url
attributes:
label: URL
- type: input
id: environment
attributes:
label: Browser, Betriebssystem und App-Version
placeholder: Chrome 154 unter macOS 26, web 4.18.0
- type: textarea
id: steps
attributes:
label: Schritte zum Reproduzieren
value: |
1.
2.
3.
validations:
required: true
- type: textarea
id: expected
attributes:
label: Erwartetes Ergebnis
validations:
required: true
- type: textarea
id: actual
attributes:
label: Tatsächliches Ergebnis
description: Füge die genaue Fehlermeldung als Text ein.
validations:
required: true
- type: dropdown
id: severity
attributes:
label: Schweregrad
options:
- Blocker
- Schwer
- Leicht
- Kosmetisch
- type: textarea
id: evidence
attributes:
label: Screenshots, Aufnahme und Logs
description: Zieh Dateien hierher oder füge einen Link zu einer Aufnahme ein.
Linear
Linear hat Issue-Vorlagen in den Einstellungen eines Teams. Leg eine Vorlage namens „Bug“ an, füge die Markdown-Version in ihre Beschreibung ein und setz das Label „Bug“ und den Triage-Status des Teams, damit jeder Report mit denselben Feldern startet.
Jira
In Jira fügst du die Text- oder Markdown-Version in die Beschreibung eines neuen Bugs ein. Jira Cloud hat keine eingebaute Standardbeschreibung pro Vorgangstyp, deshalb nutzen Teams, die die Vorlage vorausgefüllt haben wollen, eine App für Issue-Vorlagen aus dem Atlassian Marketplace. Ein Link zu einer Bildschirmaufnahme mit Konsolen- und Netzwerk-Logs gehört in die Beschreibung oder in einen Kommentar.
Fehler, die die Vorlage verhindert
Eine Vorlage ist vor allem eine Checkliste gegen immer dieselben paar Fehler:
- Mehrere Bugs in einem Report. Ein Ticket pro Problem, damit jedes für sich behoben, getestet und geschlossen werden kann.
- Umschriebene Fehlermeldungen. Nach „Da stand irgendwas mit Berechtigungen“ kann niemand suchen. Nach der genauen Meldung schon.
- Fehlender Ausgangspunkt. Schritte, die mitten in einem Flow beginnen, funktionieren nur für die Person, die sie geschrieben hat.
- Meinungen statt Beobachtungen. „Die API ist kaputt“ ist eine Vermutung. „POST /api/orders hat 500 zurückgegeben“ ist eine Tatsache, die der Entwickler prüfen kann.
- Geheimnisse in Anhängen. Screenshots von Admin-Panels, HAR-Dateien und Konsolen-Logs können Tokens und Kundendaten enthalten. Zuschneiden, verpixeln oder bereinigen, bevor du sie anhängst.
Mach sie zum Standard in deinem Team
In den meisten Issue Trackern kannst du eine Standardbeschreibung oder eine Issue-Vorlage hinterlegen, sodass jeder neue Bug mit diesen Überschriften startet. Halte die Vorlage so kurz, dass die Leute sie auch wirklich ausfüllen. Ist ein Feld in den meisten Reports leer, streich es. Stellen Entwickler immer wieder dieselbe Rückfrage, ergänze ein Feld dafür.
Lass das Tool die technischen Felder ausfüllen
Am häufigsten übersprungen werden die technischen Felder: Browserversion, Konsolenfehler, der fehlgeschlagene Request. Midge, eine kostenlose Chrome-Erweiterung, hängt sie automatisch an eine Bildschirmaufnahme oder einen Screenshot, sodass die meldende Person nur Titel, Schritte und erwartetes Ergebnis schreibt. Jede Aufnahme enthält Konsolen-Logs, Netzwerk-Requests, Nutzeraktionen und Geräteinfos. Passwörter, Kartennummern, Tokens und Cookies werden in deinem Browser geschwärzt, bevor irgendetwas dein Gerät verlässt. Ein Report geht direkt an Jira, Linear, GitHub Issues oder Slack oder wird als Link geteilt, den du überall einfügen kannst.
Verwandte Anleitungen
Häufige Fragen
Was gehört in eine Bug Report Vorlage?
Ein klarer Titel, die Umgebung (URL, Browser, Betriebssystem, App-Version, Account), nummerierte Schritte zum Reproduzieren, erwartetes Ergebnis, tatsächliches Ergebnis, wie oft der Fehler auftritt, Schweregrad und Belege wie Screenshots, ein Video, Konsolen-Logs und Netzwerk-Requests.
Kann ich die Vorlage in Jira, Linear oder GitHub Issues verwenden?
Ja. Sie ist reiner Text mit Markdown-freundlichen Überschriften, du kannst sie also in jeden Tracker einfügen. GitHub und Linear können sie außerdem als Issue-Vorlage speichern, Jira mit einer App aus dem Marketplace.
Wo liegen GitHub Issue-Vorlagen?
Im Ordner .github/ISSUE_TEMPLATE des Repositorys. Eine .md-Datei fügt eine Markdown-Vorlage hinzu, eine .yml-Datei ein Issue-Formular mit Pflichtfeldern. GitHub listet sie auf, wenn jemand ein neues Issue anlegt.
Was ist der Unterschied zwischen Schweregrad und Priorität?
Der Schweregrad beschreibt, wie stark der Bug das Produkt oder die Nutzer beeinträchtigt. Die Priorität beschreibt, wie bald das Team ihn behebt. Ein schwerer Bug in einem selten genutzten Admin-Bildschirm kann eine niedrigere Priorität haben als ein kosmetischer Bug auf der Preisseite.
Muss ich jedes Feld ausfüllen?
Nein. Titel, Schritte, erwartetes und tatsächliches Ergebnis sind unverzichtbar. Den Rest füllst du aus, wenn du ihn kennst, und schreibst „unbekannt“, statt zu raten.