Quality Reports

Learn how to write high-quality reports

Updated over a week ago

By submitting reports to the program's inbox, you're able to notify programs of vulnerabilities. Not all great vulnerability reports look the same, but many share these common features:

  • Detailed descriptions of your discovery with clear, concise, reproducible steps or a working proof-of-concept (POC). If you do not explain the vulnerability in detail, there may be significant delays in the process, which is undesirable for everyone.

  • Screenshots and/or videos can sometimes assist security teams in reproducing your issue. Most teams prefer written reproduction steps, but screenshots and videos can be used to augment your report and make it easier for security teams to quickly understand the issue you're reporting.

  • The impact of the vulnerability; if this bug were exploited, what could happen? Security teams need to file bugs internally and get resources to fix these issues. Describing why the issue is important can assist in quickly understanding the impact of the issue and help prioritize response and remediation.

It's best to be comprehensive, yet concise as security teams need to have all the details required to verify and validate your report. We recommend you provide enough information to

  • Outline the bug

  • Reproduce the bug

  • Assess the coverage the bug applies to

  • Provide additional related logs or information


Here are some examples of publicly disclosed examples of good reports:

Some great resources for vulnerability report best practices are:

Did this answer your question?