Bug Report Template for SaaS Products
SaaS bugs have unique dimensions: they may affect specific tenants, specific plan tiers, or specific configurations. A bug report that does not include tenant context wastes engineering time trying to reproduce issues that depend on environment-specific factors.
This template adds SaaS-specific fields to ensure bugs are reproducible and their blast radius is understood.
Template sections
4 sections covering the complete bug report workflow.
Tenant Context
Include the affected tenant ID, plan tier, and account age. SaaS bugs often depend on tenant-specific configuration, data volume, or feature flags. Documenting the tenant context speeds up reproduction and helps identify if the issue is isolated or widespread.
Plan Tier Reproduction
Document which plan tier the bug occurs on. Test on other tiers to determine if the bug is tier-specific (feature gating issue) or universal. Tier-specific bugs are often caused by incorrect feature flag evaluation or plan-tier permission checks.
Blast Radius Assessment
Assess the blast radius: is this affecting one tenant, multiple tenants, or all tenants? Check monitoring dashboards and error logs to determine scope. A bug affecting all Enterprise tenants has a different priority than one affecting a single Free tier user.
Data Isolation Check
If the bug involves data display or access, verify that no cross-tenant data leakage occurred. Check audit logs for unauthorized access. Data isolation bugs are always Severity-1 in SaaS products regardless of the functional impact.
Copy-paste template
## SaaS Bug Report ### Summary [Bug description] ### Tenant Context - Tenant ID: [UUID] - Plan tier: [Free / Pro / Enterprise] - Account age: [X months] - Feature flags: [Relevant flags] ### Blast Radius - Affected tenants: [1 / Multiple / All] - Affected tiers: [Specific tier / All] - Data isolation: [Verified OK / BREACH — escalate immediately] ### Steps to Reproduce 1. [Step 1 — include tenant-specific context] 2. [Step 2] ### Expected / Actual - Expected: [Result] - Actual: [Result] ### Severity - Functional: [Blocker/Critical/Major/Minor] - Data isolation: [OK / Breached]
Frequently asked questions
Generate instead of filling in templates
Connect your tools, and Vantage generates the content using real product data. Free to start.
Free to start. No credit card required.