How to Report a Bug or Issue to a Software Company
A well-written bug report gets fixed faster. Here is how to describe the issue so the support team can actually help you.
A note on this topic: This message is general guidance for everyday communication. For situations involving legal rights, medical decisions, workplace disputes, or financial obligations, consider consulting a qualified professional for advice specific to your situation.
Clear Bug Report
RecommendedHello [Support Team / Company Name], I would like to report an issue I am experiencing with [product name / feature]. Issue summary: [One-sentence description] Details: - What I was trying to do: [expected behavior] - What actually happened: [actual behavior] - Steps to reproduce: 1. [Step 1] 2. [Step 2] 3. [Step 3] - Device / Browser: [e.g., MacBook Pro, Chrome 120] - Account email: [your email] I have attached [screenshots / screen recording / error message] for reference. This issue is affecting [my ability to work / my team / our account], so I would appreciate it being looked into when possible. Thank you, [Your Name]
Subject Line
Bug Report: [Brief Description] - [Product Name]
Alternative Versions
More Direct Version
directHi Support, [Product] has a bug: [description]. Steps to reproduce: [steps]. Expected: [X]. Actual: [Y]. Screenshots attached. [Your Name]
Warmer Version
warmHi there, I love using [Product] and wanted to flag something I ran into. [Description of issue.] I have included screenshots and steps to reproduce below -- hopefully that makes it easier to track down. Thanks for all the great work on the product! [Your Name]
If this helped, you can support the project
Everything here is free. Donations help keep it running and improving for everyone.
Free bonus templates
Get more life admin message templates
Copy-and-paste messages for appointments, cancellations, follow-ups, and everyday admin.
When to Use This
Use this when: - You have found a reproducible bug - Self-help articles did not solve it - You want it fixed quickly and need to communicate clearly - You can provide screenshots or steps to reproduce
What Not to Say
Avoid: - "Your app is broken" with no details - Being rude to the support team - Reporting user error as a bug - Skipping the steps to reproduce - Demanding an immediate fix without context