Find and fix problems using the Issues tool

The Issues tool automatically analyzes the current webpage, reports issues grouped by type, and provides documentation to help explain and resolve the issues.

The Issues tool provides feedback in the following categories:

  • Accessibility.
  • Compatibility across browsers.
  • Performance.
  • Progressive Web Apps.
  • Security.
  • Other.

Feedback in the Issues tool is provided by several sources, including the Chromium platform, Deque axe, MDN browser compatibility data, and webhint. For information about these sources of feedback that populate the Issues tool, see:

Opening the Issues tool

  1. Go to a webpage that contains issues to fix. For example, open the accessibility-testing demo page in a new tab or window.

  2. Open DevTools. After a few seconds, the Issues counter (Issues counter.) appears in the upper right corner of DevTools.

  3. Refresh the page, because some issues are reported based on network requests. Notice the updated count in the Issues counter.

  4. Select the Issues counter. The Issues tool opens with issues grouped into different categories.

    Categories of issues in the Issues tool on the demo page

Other ways to open the Issues tool

There are several additional ways to open the Issues tool:

  • Click the More Tools (+) menu in the main panel or the Drawer, and then select Issues.
  • Select Customize and control DevTools > More tools > Issues.
  • In the DOM tree in the Elements tool, press Shift and then click a wavy-underlined element name. Or, open the context menu on a wavy-underlined element and then select View issues.

Issues are automatically ordered by severity

Within each category of issues, first the errors are listed, then warnings, and then tips.

The Issues tool displays Performance issues sorted by severity

Expand entries in the Issues tool

The Issues tool presents additional documentation and recommended fixes to apply to each issue. To expand an issue to get this additional information, select an issue, as follows.

  1. Open the accessibility-testing demo page in a new window or tab, and then open DevTools.

  2. Open the Issues tool by selecting the Issues counter (Issues counter.).

  3. Select an issue, to expand the issue.

    The Issues tool, displaying additional information on how to fix the issue

Each displayed issue has the following components:

  • A headline describing the issue.

  • A description providing more context and proposed solutions.

  • An AFFECTED RESOURCES section that links to resources in DevTools, such as the Elements, Sources, or Network tool.

  • Links to further documentation.

View issues in context of an associated tool

An issue in the Issues tool may include one or more links that open different tools, such as the Elements, Sources, or Network tool. You can open one of these tools to perform additional troubleshooting steps.

To open a linked tool from the Issues tool:

  1. As described in the previous section, open the demo page and then expand an issue in the Issues tool.

  2. In AFFECTED RESOURCES > Open in, select the tool name. The affected resource is displayed in the selected tool:

    Select a tool, to open an affected resource from within the Issues tool

    An expanded issue may have a Network link, to display the affected resource in the Network tool:

    The Network tool opens when you select a Network resource link

Open issues from the DOM tree

If an element has an associated issue, the DOM tree in the Elements tool shows a wavy underline under the element name. Right-click the element and then select View issues. Or, press and hold Shift and then click the element with the wavy underline.

To display an issue for elements with wavy underlines in the DOM tree:

  1. Open the accessibility-testing demo webpage in a new window or tab.

  2. Right-click anywhere in the webpage and then select Inspect. Or, press F12. DevTools opens next to the webpage.

  3. In DevTools, select the Elements tab.

  4. In the DOM tree, expand <body> > <section> > <main> > <article id="cats">. Notice that the <img> element has a wavy underline.

    Wavy-underlined issues in the DOM tree in the Elements tool

  5. Hover over the <img> element. A tooltip displays information about the issue.

  6. Open the context menu on the element with the wavy underline, and then select View issues. The Issues tool opens and displays the issue that's associated with that element.

    Details about issues on a wavy-underlined element in the DOM tree

Filter issues

To reduce the number of issues displayed in the Issues tool, you can filter the list by severity, browser, and origin.

Filter by severity

By default, only errors and warnings are displayed. To display issues with other severity levels:

  • Click Default levels.
  • Select any number of severity levels: Tips, Info, Warnings, Errors.
  • Select Default to revert back to just warnings and errors.

The Issues panel with the Severity dropdown expanded, showing the different levels that can be selected.

Filter by browser

Issues that belong to the Compatibility category can also be filtered by browser. By default, the following browsers are tested:

  • Edge
  • Chrome
  • Firefox
  • Safari
  • Safari iOS
  • Chrome for Android
  • Firefox for Android

To change the list of browsers that are tested for compatibility issues:

  • Click Top browsers.
  • Select any of the browser category sets: Top browsers, Desktop browsers, Mobile browsers.
  • Or select any number of individual browsers from the list.
  • Click Regenerate issues to update the compatibility issues based on the selected browsers.

The Issues panel with the Browser dropdown expanded, showing the different browsers that can be selected.

Filter by origin

By default, the Issues tool only lists issues that pertain to the current web page's code. To include issues that are caused by third-party libraries or frameworks loaded by the web page too, select the Include third-party issues checkbox.

The Issues panel with the 'Include third-party issues' checkbox.

See also

Note

Portions of this page are modifications based on work created and shared by Google and used according to terms described in the Creative Commons Attribution 4.0 International License. The original page is found here and is authored by Sam Dutton (Developer Advocate). Creative Commons License. This work is licensed under a Creative Commons Attribution 4.0 International License.