How to use

Select the toggle in the bottom right corner. If using assistive technology, the button is labelled "Check Accessibility". You can also press alt A with a keyboard.

Skip to issue

Use the "Skip to issue" button to quickly cycle through all annotations. The tooltip will automatically open. You can also press alt S or alt > with a keyboard.

To go to the previous issue, press alt W or alt <

Hidden content

If you do not see an annotation, use the "Skip to issue" button to find it. An alert will pop up with a preview of the issue message. If you still do not know what the alert is referencing, it might be a false positive or an issue that a developer might need to fix.

Screenshot of Skip to issue button and an alert stating that the item may be hidden in an accordion or tab component.

Dismiss annotations

This feature gives content editors the ability to temporarily dismiss any “good” or “warning” annotation on a page while they are working.

Dismiss

Try dismissing the warning that appears when Sa11y is enabled. Then select the "Show dismissed" () button to restore the dismissed warning. This will restore all dismissed annotations on a page.

Dismiss all

Some annotations have a “Dismiss all” button that will temporarily turn off that check for the current page.

Only some annotations have a “Dismiss all” button, for example:

  • Links that open in a new tab or window without warning.
  • Links that have identical text as another link, although it points to a different page.
  • Links to PDF documents.
  • Contrast that cannot be programmatically determined.

Limitations

Dismissed annotations are unique to the web page you are editing. Dismissing a single warning will not dismiss every instance of that issue across your website. This feature uses your browser’s local web storage (a type of cookie) to “remember” which warnings you dismissed. If you clear your browser’s cache and cookies, all dismissed alerts will be restored.