Read Me Page
Validate WCAG, Section 508, HTML, CSS, Links, and Spelling


Total Validator reports its results as standard web pages that can be read by a standard browser. Three types of page are used; a Page report, an Issue report and a detailed results page. The page and issue reports provide a summary of the tests performed, together with a list of links to the detailed results pages for each page validated.

The Page report is stored in a file called 'TotalValidator.html' and the other pages are stored in a sub-folder called 'Results'. These are normally overwritten each time you run Total Validator so that you don't run out of disk space.

The typical location of these files depends on your operating system as follows:

  • Windows: C:\Users\<your_login_name>\Documents\TotalValidatorTool
  • Linux: ~/Documents/totalvalidatortool
  • macOS: <user_home>/Documents/TotalvalidatorTool

The location of this 'Documents' folder is also displayed in the 'About' menu.

You can change the name and location of these files using the save results to and unique report options on the Results tab of the Pro version.


Page report

At the top is a link to the Issue report. Then there is a summary of the validation including the version of Total Validator used, the options selected, and number of issues found:

top of the page report

Use the '+' and '-' buttons to expand or close each section. For example, you can display more information about the total errors found, with links to the reference documentation:

Total errors expanded

Underneath this are the results themselves. If there are any overall issues, that apply across all pages tested, these will appear first with a link to the reference documentation explaining each in detail. Then there is a list of all the pages tested together with a summary of the issues for each:

bottom of the page report

Each page URL displayed is a link to a detailed results page (follow the link for an explanation of the 'Display issue details' options).

You can also sort the list of results by 'Links' (the original order in which the pages were validated), by 'Path' (an alphabetic list of URLs), or by the pages with the 'Most' or 'Least' number of issues.


Issue report

At the top is a link to the Page report, followed by the same summary section. Underneath this is a list of all the issues found broken down into Errors and Warnings, the different issue types, issue numbers and finally links to the detailed results pages:

bottom of the issue report


Results page

At the top are links back to the Page report and Issue report, followed by a summary of the validation for this page, followed by a representation of the web page itself:

top of a typical results page

Normally the representation of the web page shows each of the tags within it on a separate line, with indentation showing how the tags are nested within each other. This should make it easy to read the results even with the most poorly formatted source web page or where the layout style varies across the site. It is particularly useful when the pages are generated by a computer program, as these tend to generate the most irregular web page source.

Similarly, CSS style sheets and statements within <style> tags are reformatted and reorganised to allow errors to be easily reported on.

To make it easier to read the report, the 'Hide content' checkbox toggles the display of text content and the 'Short report' checkbox hides everything except those lines with issues. You can set these in advance using the Hide content and Short report options.

The line numbers on the left refer to lines in the original source so you can quickly get to and amend the faulty tag or CSS statements in the original web page source.

Line numbers marked as '0' refer to tags added by Total Validator. These are optional tags that are implicit in the standards, but are sometimes displayed in the results as somewhere to attach errors/warnings to relating to the subsequent page.

The image below shows an example of how an error is displayed. These are highlighted and begin with an 'E' followed by a unique number for the error, then some explanatory text. Probable errors begin with a 'P' and Warnings begin with a 'W'. There are also up and down arrows next to the issue to allow you to quickly navigate to other issues on the page.

how errors are displayed

If there is more than one error associated with a tag then these are listed one after another on separate lines before the tag itself:

multiple errors

Note that column numbers referring to the original source are not displayed. This is deliberate as many issues apply to the whole tag. Also, we've found that having column numbers often detracts from understanding the issue. Instead where possible the item in question will be highlighted in red as shown above.

By default, when you hover over an issue a box will appear displaying further information about it:

more information

Instead of hovering to display this information, you can choose to always display it or always hide it using the 'Display issue details' option at the top:

display issues

You can then click the issue text instead of hovering over it to toggle the display of this extra information.

The same option also appears on the Page report, where it applies to all the Results pages. In the Pro version you can also set the default value across all the Results pages if you prefer a specific option every time.


Spelling mistakes

Potential spelling mistakes are dealt with as shown in the image below. The word that is not recognised by the dictionary is highlighted and followed by a list of suggested replacements:

how spelling mistakes are displayed

Note that the line number given refers to the first line of the content containing the spelling mistake. If the content spans multiple lines it may not match the line with the mistake on. But it should still be simple to find the mistake in the original page.

With the Pro version, if the spelling validator highlights a word which isn't a mistake, you can click on it to add it to your own dictionary of words so it doesn't appear in future validations. With all modern browsers, clicking on a word will cause the highlighting of the word and the suggestions to disappear wherever they appear in any page validated, and the link will be disabled to prevent double-clicking by mistake. With old versions of IE (anything earlier than IE10), when you click on a word a new page will appear with a confirmation message and you will have to use the back button to continue to add further words or to continue to view the validations results.

Note that ad-blocking and other blocking extensions can prevent spell check corrections from being sent to Total Validator, so you may need to disable these on results pages.