Assessment in Accessibility Insights for Web

What is an assessment?

An assessment is a comprehensive process that measures compliance with Web Content Accessibility Guidelines (WCAG) 2.2 Level AA success criteria. The assessment process currently includes 24 tests, and each test covers one or more accessibility requirements.

There are three types of requirement:

  • Automated – the tool identifies instances and evaluates them automatically.
  • Assisted – the tool actively helps you identify or evaluate instances.
  • Manual – the tool provides instructions for identifying and evaluating instances.

Note: Completing an assessment requires you to use standard keyboard commands and to visually identify interactive interface elements.

How to complete an assessment

Get ready to test

  1. In Chrome or the new Microsoft Edge, navigate to the page you want to test (aka the target page).

  2. Open Accessibility Insights for Web:

    • Select the extension icon.

    or

    or

    • Use these keyboard commands:

      Windows or Linux:

      1. Press Shift+Alt+T or F10 to set focus on the browser's address bar.
      2. Press the Left arrow to set focus on the Accessibility Insights for Web extension.
      3. Press the Space key to open the extension.

      MacOS:

      1. Press ⌘+L to set focus on the browser's address bar.
      2. Press the Tab key to set focus on the Accessibility Insights for Web extension.
      3. Press the Space key to open the extension.

    The Accessibility Insights for Web extension will open to the Launch pad.

    Four options are available in the Launch pad: FastPass, Quick Assess, Assessment, Ad hoc tools

  3. In the Launch pad, select Assessment.

    A secondary browser window will open to an overview of the assessment process and results. At this point, the assessment is 100% incomplete, so no results are available.

    Target page and the overview displayed side-by-side

Run the automated checks

  1. In the navigation pane, select Automated checks.

    Automated checks will run on your target page. Activate the visual helper to highlight failure instances in the target page.

  2. Review the automated check results.

You can review the automated check results in the Accessibility Insights for Web page.

Failures listed in the Accessibility Insights for Web page

Review results in the Accessibility Insights for Web page

By default, the Accessibility Insights for Web page shows:

  • The total number of failed instances
  • A list of any accessibility rules that were violated
  • The number of failed instances for each rule
  • A visual helper toggle that allows you to quickly show or hide failure highlighting in the target page

Failed rules in the Accessibility Insights for Web page

A rule can be expanded to show information about its failed instances. Rules can be expanded or collapsed:

  • All at once by using Expand all / Collapse all
  • Individually by clicking a rule, or by tabbing to it and pressing Enter

Expanding a rule:

  • Shows links to additional information about the rule, including why it matters, examples, and detailed instructions for fixing
  • Highlights its failed instances in the target page
  • Shows the failed instances in a list

Each failed instance includes:

  • Unique identifying information about the element that failed (for example, a CSS selector)
  • How to fix the detected issue
  • Additional information to help identify the element (some rules only)
  • Buttons to take action on the individual issue. You can:
    • File an issue in your GitHub or Azure Boards repository.
    • Copy failure details to your clipboard and paste them into the tool or document of your choice.

Failed instances in the Accessibility Insights for Web page

Selecting a failed instance highlights it in the target page. You can select multiple instances. An instance can be selected or deselected by clicking it, or by tabbing to it and pressing Enter.

One failed instance selected in the Accessibility Insights for Web page and highlighted in the target page

Complete the assisted and manual tests

Each of the remaining tests covers a set of related requirements. We recommend completing the tests and requirements in the order they appear in the navigation pane.

  1. In the navigation pane, collapse the list of automated checks by selecting Automated checks.

  2. Select the next test (Keyboard).

    The navigation pane will expand to show all of the test requirements.

  3. Optional: To learn more about the test:

    1. In the navigation pane, under the test name, select Getting started.

      The main pane will update to show introductory information about the test.

    2. In the main pane, next to the page title, select Guidance .

      A new browser tab will open with additional information about the test:

      • Why it matters
      • Do-and-don't design guidelines
      • Links to relevant WCAG success criteria, sufficient techniques, and common failures.

      Test guidance opened in a new browser tab.

  4. In the navigation pane, under Keyboard, select the first requirement (Keyboard navigation).

    The main pane will update to show test instructions for the selected requirement.

    Test instructions in the main pane

  5. Optional: To learn more about a requirement, select Guidance .

    A side panel will open with detailed information about the requirement:

    • Why it matters
    • From a user's perspective (where applicable). This is a contribution from the Design for People Guidelines.
    • How to fix
    • Examples
    • Code snippets (where applicable)
    • Links to relevant WCAG success criteria, sufficient techniques, and common failures.

    Requirement guidance in a side panel

  6. Read the instructions under How to test.

  7. Evaluate the instances and record your results.

    Some requirements in an assessment require you to manually identify the instances to evaluate. (All of the requirements in the Keyboard test require you to manually identify instances.)

    Some requirements automatically generate a list of instances to evaluate. (The first requirement that generates a list of instances is in the Landmarks test.)

    • For manual requirements:

      1. Select Pass or Fail for the requirement.

        Tip: You can reset a requirement to its original indeterminate state by selecting Undo .

      2. If the requirement fails, add a failure instance. (If the requirement passes, no further input is needed.)

      Keyboard navigation requirement shows failed when one failure instance added

    • For assisted requirements, select Pass or Fail for each instance.

      Tip: You can reset an instance to is original indeterminate state by selecting Undo . Tip: After you mark all the failures, you can pass the remaining instances by selecting Pass unmarked instances.

      Link function requirement shows failed when instance marked as failed

  8. Select the next requirement, follow the instructions, and record your results.

  9. Repeat with the remaining tests.

  10. When every requirement in every test is marked as Pass or Fail, your assessment is complete.

View a summary of the assessment results

At any time, select Overview in the navigation pane.

Overview showing results of a completed assessment

Share a detailed report of the assessment results

  1. In command bar near the top of the page, select Export result.

    A dialog will open.

  2. Optional: In the dialog, provide a description for the report.

  3. Select Export and choose one of the options.

To export as HTML

The HTML report groups results by the tests in Assessment and provides a summarized view of all the requirements and their state (pass, fail or incomplete).

  1. In the Export dialog, under the Export dropdown, select Export as HTML.

An HTML report will automatically download to your computer. Depending on your browser, the report might open automatically in a new browser tab, or you might have to open it manually. Report showing results of a completed assessment

To export as JSON

The JSON report groups results by the Success Criteria and provides a list of all the requirements under each S.C. The date for the JSON report is exported in ISO 8601 format and the report version is the same as the Accessibility Insights for Web extension version.

  1. In the Export dialog, under the Export dropdown, select Export as JSON.

A JSON report will automatically download to your computer.

Start Over

Start a new assessment

Data collected in an assessment will persist until you start a new assessment.

  1. In the command bar near the top of the page, select Start over > Start over assessment.

    Note: Depending on the width of your browser window, you might have to select the More items disclosure button to access Start over.

  2. In the confirmation dialog, select Start over.

    All data in the assessment will be cleared, and you will automatically navigate to the assessment Overview.

Start over a single test

Data collected in a specific test will persist until you start over the test (or start a new assessment).

  1. Navigate to the test you want to start over.

  2. In the command bar near the top of the page, select Start over > Start over <test name>.

    Note: Depending on the width of your browser window, you might have to select the More items disclosure button to access Start over.

  3. In the confirmation dialog, select Start over.

    All data in the test will be cleared, and you will automatically navigate to the first requirement in the test you started over.

Save and Load an in-progress assessment

At any time, you can save an in-progress assessment and load it later on.

Save an assessment

  1. In the command bar near the top of the page, select Save assessment.

    The assessment file (a11ywebassessment) will automatically download to your computer.

Load an assessment

  1. In the command bar near the top of the page, select Load assessment.

    A file explorer will open.

  2. In the file explorer, select the assessment file you want to load.

    Note: Data collected in an assessment persists until you load or start a new assessment. If there is an in progress assessment already, a confirmation dialog will appear. Loading an assessment will clear all data in the local in-progress assessment.