# Site Validation Reports

> Canonical HTML version: https://rocketvalidator.com/docs/site-validation-reports
> Attribution: Rocket Validator (https://rocketvalidator.com)
> License: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/)

A site validation report shows the results of running the selected engines (W3C Validator, Axe Core and/or AccessLint Core) on the web pages our scraper found on your site.

There are three main sections in a site report:

* **Summary** shows the main counters and scores, a selection of the highest-impact issues on the site, and a list of the most affected pages.
* **Web Pages** lists all the web pages our scraper found on your site, so you can check the specific issues on each one.
* **Issues** groups those individual issues into common issues, so you can see each distinct problem across the whole site.

Let's look at each one.

## Summary

The Summary shows the site's main counters and scores, along with the issues and pages that need the most attention based on their impact.

### Scores and counters

![Scores and counters section](https://rocketvalidator.com/images/docs/report_summary_01.webp)

The first section of the Summary opens with an **Overview** card showing the number of web pages included in the report, the total number of checks and the date of the last check. Below it there's one row per kind of check (HTML by W3C Validator, accessibility by Axe Core and/or accessibility by AccessLint Core), each with its score and issue counters. On the right side, a preview panel shows a screenshot of the site at the selected device viewport resolution.

The score is the percentage of web pages that are completely free of issues. For example, if 30 out of 100 pages are clean, the score is 30%. There is one score per engine: HTML, Axe accessibility and AccessLint accessibility.

Each engine card shows its counters: the number of errors and warnings for the HTML checks, and the number of issues by severity (critical, serious, moderate, minor) for the accessibility checks.

### Where to start

![Where to start section](https://rocketvalidator.com/images/docs/report_summary_02.webp)

This section lists the top issues on the site, the ones with the highest impact. For each one, we show its description, a short introduction from the help guide, and the engine that reported it, with **View issue** and **How Fix** buttons to open the issue itself and its help guide.

### Needs manual review

![Manual review section](https://rocketvalidator.com/images/docs/report_summary_03.webp)

If you enabled the option to store manual reviews when setting up the report, this section highlights the top issues that need one, much like the section above.

### Most affected pages

![Most affected pages](https://rocketvalidator.com/images/docs/report_summary_04.webp)

This section lists the pages that carry the most issues compared to the rest of the site.

## Web Pages

The Web Pages section lists every page included in your site validation report, showing how many issues each engine found on it. Use the checkboxes to select several pages and re-check or delete them in bulk.

![Web Pages list](https://rocketvalidator.com/images/docs/web_page_list.webp)

Use the list/grid toggle to switch between the table and a screenshot mosaic of the pages, handy for a visual overview of the whole site.

![Web Pages screenshot mosaic](https://rocketvalidator.com/images/docs/web_page_list_mosaic.webp)

Click a web page to see all its details and issues.

### URL, device preview and actions

![Web Page URL and actions](https://rocketvalidator.com/images/docs/web_page_01.webp)

The top section of the Web Page shows its URL, where it was linked from (that's how the scraper discovered it), which engines checked it, and two action buttons:

* **Re-check this page** lets you run the checks again for the current page.
* **Open page** opens the page at the device resolution in a separate window.

Next to it you'll see a preview of the page at the emulated device viewport, labeled with the device name and resolution.

![Device viewport preview](https://rocketvalidator.com/images/docs/web_page_01_preview.webp)

### Engine counters

![Engine counters](https://rocketvalidator.com/images/docs/web_page_02.webp)

For each engine used (W3C Validator, Axe Core and/or AccessLint Core), you'll see the total number of issues, along with a breakdown by severity.

### Issues on this page

![Issue list for page](https://rocketvalidator.com/images/docs/web_page_03.webp)

This shows every issue found on this page, grouped by issue. You can apply several filters to narrow down what you're looking for.

#### Filtering by engine and confirmation status

![Engine and status filters](https://rocketvalidator.com/images/docs/web_page_03_filter_engine_status.webp)

These filters let you narrow down the issue list by:

* **Engine**. Show all issues, or only those reported by W3C Validator, Axe Core or AccessLint Core.
* **Status**. Show all issues, only confirmed ones, or only those that need a manual review. W3C Validator and AccessLint Core only produce confirmed issues, while Axe Core produces both violations and "incomplete" checks that need a manual review.

### Filtering by issue

![Issue filter](https://rocketvalidator.com/images/docs/web_page_03_filter_issue.webp)

This lists the different issues on the page, along with how many elements each one affects. Click an issue to see its details in the pane on the right.

### Issue elements

![Issue elements](https://rocketvalidator.com/images/docs/web_page_03_issue_elements.webp)

This shows the issue details and the elements it affects on the current page. Use the navigation buttons to move between them. Each element shows an HTML snippet and, where available, a CSS selector and a **Highlight** button that displays it directly on your live web page (this requires the <a href="https://chromewebstore.google.com/detail/inafapaecdgclllddapjcnilmgmebipo?utm_source=item-share-cb" target="_blank">Rocket Validator Highlighter Chrome extension</a>; without it the button reads **Install Highlighter** and links to the Chrome store).

Finally, the **Open common issue** link takes you to the common issue page, where you'll find its context and the other web pages affected by the same problem.

## Issues

Where the Web Pages section looks at your site one page at a time, the Issues section looks at it one problem at a time. It groups every individual issue found across the site into **common issues**, with one row per distinct problem. A single common issue (for example, a color contrast problem) can affect many elements across many pages, so this view lets you work through problems by impact instead of page by page.

![Issues list](https://rocketvalidator.com/images/docs/issues_01.webp)

Each row is a common issue, described by these columns:

* **Impact** combines the severity with the issue type, from errors and warnings (W3C Validator) to critical, serious, moderate and minor errors or warnings (Axe Core and AccessLint Core).
* **Issue** is the description of the problem.
* **Source** is the engine that reported it: W3C Validator, Axe Core or AccessLint Core. Axe Core issues that need a manual review are flagged with a **Manual review** badge.
* **Volume** is a bar that shows, at a glance, how widespread each issue is compared to the rest.
* **Count** is the total number of individual issues of this type found across the site.

Click any column header to sort by it, and use the **Search issues** box to filter the rows by text. The counter at the bottom tells you how many issue types and how many individual issues are currently in view.

Click a row to open its common issue page, described below.

### Filtering issues

![Issues filters](https://rocketvalidator.com/images/docs/issues_02.webp)

The **Filters** button opens a sidebar that narrows down the list. Every option shows the number of matching issues next to it, the button displays a badge with the number of active filters, and **Clear all** resets them at once.

* **Engine**. Show all issues, or only those reported by W3C Validator, Axe Core or AccessLint Core.
* **Status**. Show all issues, only **Confirmed** ones, or only those that **Need manual review**. W3C Validator and AccessLint Core only produce confirmed issues, while Axe Core produces both confirmed violations and "incomplete" checks that need a manual review.
* **Impact**. Show only errors or only warnings.
* **Tags**. Every issue is tagged with the standards and categories it relates to (WCAG, ACT, ARIA, alt, color…). Pick one or more tags and choose whether an issue must match **any**, **all** or **none** of them.

### Issue detail

Clicking an issue opens its **common issue** page, which gathers everything about that single problem across the whole site. As an example, we'll look at the AccessLint Core issue *"Insufficient color contrast ratio of 3.78:1 (required 4.5:1)"*.

![Common issue header and summary](https://rocketvalidator.com/images/docs/issues_03.webp)

The top of the page shows the issue **impact**, the engine and rule that reported it (`accesslint · distinguishable/color-contrast`) and its full description. Two buttons let you **Re-check the affected pages** or **Mute** the issue so it no longer shows up in this report.

Below the header, a set of cards summarizes the issue: the number of **pages affected** out of the total, the number of **elements flagged**, the **impact** level, and when it was **last found**. The **What this issue means** card adds a short, plain-language explanation, with a link to **Read the full help for this rule** in our guides.

#### Affected elements

![Affected elements viewer](https://rocketvalidator.com/images/docs/issues_04.webp)

The **Affected elements** section lets you inspect every element flagged by this issue, page by page.

On the left, a list shows each affected web page along with how many elements are flagged on it. You can filter this list by URL and page through it, then select a page to load its flagged elements on the right. From there, **Open in Web Pages** opens this same issue on the selected page, over in the Web Pages section, so you can see it in the full context of that page.

The viewer on the right steps through each flagged element with the pager, showing:

* The **CSS selector** and a **Highlight** button that displays the element directly on your live web page (requires the <a href="https://chromewebstore.google.com/detail/inafapaecdgclllddapjcnilmgmebipo?utm_source=item-share-cb" target="_blank">Rocket Validator Highlighter Chrome extension</a>; without it the button reads **Install Highlighter**).
* The **HTML snippet** of the offending element, with the exact problem reported by the engine.
* The **Context** with the details needed to fix it. For color contrast issues this shows the measured **contrast ratio** next to the required one, plus the foreground and background colors and the text size. Its **Fix Contrast** button opens the [Rocket Validator Contrast Checker](https://tools.rocketvalidator.com/contrast-checker) with those colors pre-filled, so you can work out an accessible combination.
