Understanding Sa11y Results

Modified on Mon, 13 Jul at 3:09 PM

Overview

Sa11y reviews the content on your current page and reports potential accessibility issues. Each result includes a description of the issue and, when possible, guidance for resolving it.

Not every result requires the same level of attention. Some issues should always be corrected, while others require editorial review and judgment.

Errors

Errors identify accessibility issues that should be corrected before publishing.

These issues are likely to create barriers for visitors using assistive technologies and are often straightforward to resolve.

Common examples include:

Missing alternative text
Empty links
Missing form labels
Invalid heading structure

Whenever possible, resolve all reported errors before publishing your page.

Warnings

Warnings indicate content that should be reviewed by the editor.

A warning does not always mean something is incorrect. Instead, Sa11y has identified content that may require a decision based on the context of the page.

Examples include:

Link text that may not be descriptive enough
Complex tables
Long alternative text
Content that may require manual review

Read the explanation provided by Sa11y before making changes.

Informational Messages

Informational messages provide recommendations or reminders that can improve the overall quality of your content.

These messages do not necessarily indicate an accessibility problem but may highlight opportunities to improve usability or readability.

Reviewing Issues

As you work through the results:

Read the issue description.
Review the highlighted content on the page.
Make any necessary corrections.
Save your changes.
Run Sa11y again to verify the issue has been resolved.

If you are unsure how to resolve a specific issue, refer to the related accessibility article or contact Web Services for assistance.

Remember

Sa11y is designed to assist content editors, not replace editorial judgment.

Some warnings require you to decide whether the content is appropriate for your audience, while others may identify issues that originate from website templates or custom functionality.

When in doubt, review the recommendation carefully before making changes.