Issue filing in Accessibility Insights for Web

Accessibility Insights for Web makes it easy to file issues directly from automated check failures.

How to file issues

Configure your issue filing service

  1. 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 tool bar.
        2. Press the Left Arrow key 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 tool 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.

    The Launch pad open with the mouse hovering over the Settings button

  2. Open Settings:

    • Use the mouse:

      1. Click Manage settings .
      2. In the menu, Click Settings.

    or

    • Use these keyboard commands:

      1. Use the Tab key to navigate to Manage settings .
      2. Press the Enter key to open the menu.
      3. Press the Enter key again to select Settings.

    A Settings panel will open in a new browser window.

To configure GitHub issue filing

  1. In the Settings panel, under Issue filing, select GitHub.
  2. Enter the URL of your GitHub repository's Issues tab. Example: https://github.com/owner/repo/issues
  3. Close the Settings panel (X icon).

or

  1. Use the Tab key to set focus on the currently selected Issue filing option. If needed, use the Up arrow or Down arrow key to select GitHub.
  2. Tab to the Enter your GitHub issues URL box, then enter the URL. Example: https://github.com/owner/repo/issues
  3. Tab to the Close Settings Panel button, then press the Enter key.

Accessibility Insights for Web with the Settings panel open. Under Issue filing, GitHub is selected.

To configure Azure Boards issue filing

  1. In the Settings panel, under Issue filing, select Azure Boards.

  2. Enter the URL of your Azure Boards project. Example: https://dev.azure.com/org/project

  3. Select the field where you want issue details to appear:

    1. If your project tracks bugs, select Repro steps.
    2. If your project tracks issues, select Description.
  4. Close the Settings panel.

or

  1. Use the Tab key to set focus on the currently selected Issue filing option. If needed, use the Up arrow or Down arrow key to select Azure Boards.

  2. Tab to the Enter your Azure Boards project link box, then enter the URL. Example: https://dev.azure.com/org/project

  3. Tab to the Select a field for issue details dropdown, use the Up arrow or Down arrow key to select an option, and then press the Enter key:

    1. If your project tracks bugs, select Repro steps.
    2. If your project tracks issues, select Description.
  4. Tab to the Close Settings Panel button, then press the Enter key.

Accessibility Insights for Web with the Settings panel open. Under Issue filing, Azure Boards is selected.

Run automated checks

Detailed instructions for running automated checks are available in FastPass.

File an issue

  1. Find the failure instance you want to file as an issue.

  2. Open a new issue form:

    1. In the bottom right corner of the failure instance card, select More actions (vertical ellipsis icon).
    2. In the menu that opens, select File issue.

    or

    1. Use the Tab key to set focus on a failure instance's More actions button, then press the Enter key to open the menu.
    2. Press the Enter key again to select File issue.

    A failure instance with the More actions menu open and the mouse hovering over File issue.

    If you're using GitHub, a New Issue form will open:

    A GitHub New Issue form with failure details.

    If you're using Azure Boards, and your project tracks bugs, a New Bug form will open:

    An Azure Boards New Bug form with failure details.

    If you're using Azure Boards, and your project tracks issues, a New Issue form will open:

    An Azure Boards New Issue form with failure details.

    If you're using Azure Boards, a Sever Error page will open if there's a problem with your issue filing configuration:

    An Azure Boards Server Error page.

    To resolve this problem:

    1. In Accessibility Insights, go to Settings > Issue filing > Select a field for issue details, and choose a different option.
    2. If the problem persists, make sure the bug or issue work item type is enabled in Azure DevOps.
  3. The New Bug or New Issue form will open with failure details automatically populated. If desired, edit the information in the form.

  4. Save the new issue:

    • If you're using GitHub:

      • Select the Submit new issue button.

      or

      • Use the Tab key to set focus on the Submit new issue button, then press the Enter key.
    • If you're using Azure Boards:

      • Select the Save button.

      or

      • Press Ctrl+S on your keyboard.

      or

      • Use the Tab key to set focus on the Save button, then press the Enter key.

Copy failure details

If you want to record an issue without filing it on GitHub or Azure Boards, you can copy the failure details to your clipboard and then paste them into the tool or document of your choice.

  1. In the bottom right corner of a failure instance card, select More actions (vertical ellipsis icon).
  2. In the menu that opens, select Copy failure details.

or

  1. Use the Tab key to set focus on a failure instance's More actions button, then press the Enter key to open the menu.
  2. Use the Up arrow or Down arrow key to select Copy failure details.
  3. Press the Enter key to copy the failure details to your clipboard.

A failure instance with the More actions menu open and the mouse hovering over Copy failure details.