Skip to main content

Bug Report Template

Copy this into Linear, Jira, GitHub, Slack, or email when reporting an issue.

Title:

Severity: Blocker / High / Medium / Low

Build Version:

Build Type: TestFlight / APK / local dev / web / other

Platform: iOS / Android / Web / other

Device / OS:

Account / Role:

Network State: online / offline / reconnecting / flaky

Preconditions:

Steps to Reproduce:
1.
2.
3.

Expected Result:

Actual Result:

Frequency: always / often / sometimes / once

Impact:

Artifacts:
- Screenshot:
- Screen recording:
- Logs:

Notes:

Add these for sync or offline bugs

Pending Count Before:
Pending Count After:
Was Sync Now Tried?:
Did the issue survive app relaunch?:
Did the item appear duplicated after reconnect?:

Add these for permission or native bugs

Permission State Before Repro:
Physical Device or Simulator/Emulator:
Biometrics Enrolled?:
Camera/Mic/Photos permission already granted?:

Add these for admin portal bugs

Page URL:
Browser:
Viewport / Screen Size:
Was the issue visible after refresh?:

Severity guide

SeverityMeaning
BlockerCore use is stopped or data integrity is at risk
HighMajor feature broken with limited workaround
MediumImportant issue with workaround
LowMinor issue or polish gap

Good reporting tips

  • be specific in the title
  • use exact values you entered when relevant
  • include whether the issue happened on a physical device
  • attach screenshots for UI issues and recordings for workflow issues
  • Operations > QA Tester Guide
  • Operations > QA For PM And Design
  • Operations > Bug Reporting Guide