Scan Report Contents

A useful accessibility scan report includes the issue type, the WCAG success criterion it relates to, the page or template where it was detected, the element or code…

A useful accessibility scan report includes the issue type, the WCAG success criterion it relates to, the page or template where it was detected, the element or code snippet involved, a severity or impact rating, and guidance on remediation. The scan report contents should also document the scope of the scan, the date it ran, and any pages excluded or skipped due to authentication or load errors. Scans only flag approximately 25% of accessibility issues, so a quality report makes its limitations visible alongside its findings.

Core Elements of a Scan Report
Element Purpose
Scope and Metadata Documents which URLs were scanned, the date, the scan configuration, and any pages skipped.
Issue Inventory Lists each detected issue with the related WCAG success criterion and conformance level.
Location Detail Identifies the page URL, element selector, and code snippet for each issue.
Severity or Impact Rates user impact and risk so teams can prioritize remediation.
Remediation Guidance Explains what the issue is and how to correct it in code.

Scope and Metadata

A scan report opens with what the scan actually covered. That includes the list of URLs evaluated, the WCAG version and conformance level checked (typically 2.1 AA or 2.2 AA), the date of the scan, and the tool category used.

Pages that returned errors, required authentication, or were intentionally excluded should be listed. Without this context, readers cannot tell whether a clean section reflects accessible code or pages the scan never reached.

Issue Inventory Tied to WCAG

Each detected issue is linked to a specific WCAG success criterion and its conformance level. This anchors the finding to a recognized standard rather than presenting it as a generic warning.

Reports that group issues by criterion give teams a faster path to understanding patterns. A site with 200 instances of the same missing label issue is a different remediation problem than 200 unrelated issues, and the report structure should make that clear.

Location Detail for Each Finding

For every issue, the report identifies the page URL, the element involved (typically as a CSS selector or XPath), and the relevant code snippet. Without this, developers cannot locate the problem.

On templated sites, location detail also reveals whether an issue is isolated or repeats across every page generated by the same template. That distinction shapes the remediation plan.

Severity and User Impact

A scan report should rate findings by user impact and legal risk rather than treating every issue equally. A missing form label affects users more directly than a redundant landmark, and the report should reflect that difference.

Severity ratings let product and engineering teams prioritize work without rereading every entry. The most actionable reports separate critical, serious, moderate, and minor findings.

Remediation Guidance

Each issue should include a description of what the rule requires and how to correct the code. Generic warnings without remediation guidance push the work back onto the reader, who then has to research each item independently.

Quality reports include example code, references to the relevant WCAG technique, and notes on common patterns that produce the issue.

Acknowledged Limitations

A scan report should state what the tool cannot detect. Keyboard operability across complex widgets, screen reader announcement quality, focus order in dynamic interfaces, and meaningful alternative text all require manual evaluation.

Reports that present scan output as full coverage mislead the reader. The 25% detection rate is a feature of how scans work, not a flaw to hide. Pairing scan output with a manual audit closes the coverage gap, and the report should point toward that next step rather than implying the scan completed the evaluation.

Trend Data When Monitoring Is Active

When scans run on a recurring schedule, the report becomes a trend document. New issues introduced by recent code changes, resolved issues from prior cycles, and persistent issues that have not been addressed all become visible.

This historical view is what separates one-time scan output from ongoing monitoring. A single scan tells you the state of the site today. A series of scans tells you whether accessibility is improving, holding steady, or regressing.

A scan report is a working document, not a verdict. Its value comes from how clearly it identifies what was checked, what was detected, where the issues live, and what to do next.