Accessibility: Troubleshooting the Accessibility Wizard

The Accessibility Wizard is a helpful tool that can assist you in making your site more accessible for your visitors. 

Depending on the type of visual or backend content you have on your site, you may come across some issues when using the Wizard. Use the options in the article to learn more about these issues and their potential resolutions.

In order to make your site text clearly visible, the Wizard flags any areas that do not have a color contrast level of 3.0 and above for large text, and 4.5 for regular text. You may see one of these notifications when you have sufficient color contrast, but have placed text on an image.

The Wizard calculates the contrast based on the lightness of the text, and the section or strip background that the image is on. Therefore, in order to resolve this issue, you need to change the lightness of the text or background.

If you place text on top of a container box without attaching it to the container, the color contrast calculation is not correct. As a result, you may see a card flagging an issue with the contrast. 

This is because the Wizard does not recognize the container as the background, and instead calculates the contrast based on the background that the container is on (e.g. a strip or section).

In order to resolve this issue, you need to attach the text to the container box. 

Heading tags define your page content's hierarchy, and allow visitors to navigate through it. If you do not define the text on your page, the Wizard may display cards prompting you to set the page's main heading, and the heading tags of other text.

You may see a card in the Wizard flagging linked text across your site, or encouraging you to check it manually. This is because generic linked text (such as 'Read more') does not clearly describe what happens when visitors click it.

We recommend ensuring that any linked text you add to your site is descriptive, and advises visitors of its function (e.g. 'Read the reviews for our show').

If you connect an image to a dataset and add alt text to it through the connection, you may be prompted to add alt text again in the Accessibility Wizard. This is because the Wizard does not read your site's datasets, and takes the information from the image's settings.

In order to resolve / prevent the alt text card, we recommend adding good alt text to the image in the Wix Editor. Once you've connected the image to the dataset, you can check that the alt text field is connected to the alternative text you added in your editor.

ARIA attributes provide additional information about the semantics of elements to assistive technologies. We only recommend adding ARIA attributes to custom web applications on your site, since most other elements have pre-coded attributes. 

As alternative text provides information about your site media to assistive technologies, it is not necessary to also add ARIA attributes. 

The Wizard may highlight issues that you have already resolved in step 3. For example, if you have added an accessibility statement (and marked it as complete in the Wizard), the card may reappear when you scan the site again.

The changes / settings you saved should still be applied to the site - just click the button to mark it as done.