How do I use WAVE?

What is WAVE? 

WAVE is a free automatic accessibility testing tool that can help find WCAG violations, potential issues, and provide remediation guidance for your website in real time. 

No automatic accessibility scanner can find all accessibility issues on your website. This means that manual testing is required to make sure all accessibility issues on your website are found and fixed. 

Getting started with WAVE

Use the website tool  

Navigate to WAVE and enter the URL of the site you want to test. A report will be generated with details about errors, features, and potential issues. 

Use the browser extension 

Install your preferred browser extension 

After you install it, a small WAVE icon appears in your browser toolbar. 

Example of the WAVE extension icon: 

A screenshot of the WAVE browser icon.

Understanding your WAVE report 

Details

Screenshot of the "Details" Panel in WAVE

The Details panel will most likely be where you spend the majority of your time while using WAVE. 

From here, you can find more information on: 

  • Errors - These are known issues that need to be corrected. Examples of errors might include broken skip links, images without alt text, and empty links. 
  • Alerts - These are potentially accessibility issues, but need a real person to double check. Examples of alerts might include skipped heading levels, broken links, suspicious alt text, and suspicious link text.
  • Features - These are accessibility additions on your page. Some examples might include images with alt text, form labels, designated page language, and skip link targets.
  • Structural Elements - This outlines how your page is organized. You can find your tagged heading levels, your list tags, and your landmark elements here.
  • ARIA - ARIA is a set of labels you can add to websites to help assistive tech describe what’s on the page. It makes buttons, menus, and other web features easier to use.

Tips:

Select the 'i' icon next to your results for more information about each element.This will take you to the Reference panel, and point to additional training and resources. 

Screenshot of a WAVE report with an arrow pointing toward the "i" icon next to the "alert" element..

Toggle details 'on' and 'off' in your report using the checkboxes next to each element. This makes it easier to understand all of the elements on the page and find what you are looking for.

Screenshot of an arrow pointing toward the checkbox toggle available in WAVE.

Reference

Screenshot of the "Reference" Panel in WAVE

The Reference panel is where you’ll go if you want more information about the issues listed in the Details panel of your WAVE report. It explains what’s happening on your page and gives you more details about the WCAG guidelines.

Order

Screenshot of the "Order" Panel in WAVE

The Order panel breaks down exactly your page structure and what order assistive technology will interact with your page content. This is helpful in making sure all of the content on your page is presented in a logical reading order.

Confirm that the order of your content starts at the top left and moves through your page in the order you are expecting.

Structure

Screenshot of the "Structure" Panel in WAVE

The Structure panel shows how your page is organized and gives more detailed information on heading levels and landmarks. 

Contrast

Screenshot of the "Contrast" Panel in WAVE

The Contrast panels lets you quickly review any color contrast issues that might be on your page and test different color combinations. 

Tips for using WAVE

  • Combine WAVE with manual testing. WAVE is an automatic accessibility testing tool that can help get you started in your review, but can’t find all the accessibility issues on your site. A manual test is needed to find and correct all issues. 
  • Test multiple pages. Some issues might be on all of your pages, or can be fixed on new pages when they are added. 
  • Test your pages after you make updates. This helps you catch and fix issues fast. 

Additional Resources 

Introduction to WAVE (video 11:20)

Introduction to WAVE