Skip to main content

Check your site for issues with Site Health

Use Site Health to review HTML structure, link settings, and alt text issues in a single list in the Design Editor. Learn how to jump to flagged elements and check suggested fixes.

Site Health detects settings that can cause problems on your published site and shows them in a list. You can check your entire site from three perspectives: HTML structure, link settings, and image alt text.

Click an issue in the list to jump to the element, and check how to fix it right there.

What Site Health checks

Site Health detects three types of issues that are hard to notice in the Design Editor.

Category

What it detects

HTML structure

Skipped heading levels, incorrect list or landmark structure, and more

Link settings

Missing link destinations, links to pages or IDs that don't exist, links to unpublished pages, and more

Alt text

Images without alt text

These issues can also prevent screen readers and search engines from correctly reading your page content.

For details on each category and how to fix it, see Site Health issues and how to fix them.

Open Site Health

Open Site Health from the left panel of the Design Editor.

  1. Click [Site Health] on the left side of the Design Editor.

    Design Editor with the Site Health icon at the bottom left highlighted

  2. The Site Health panel opens and shows the results in a list.

    Left panel showing the list of Site Health results

Review issues

Issues are grouped by page in the list. Switch the page scope or breakpoint as needed.

Switch pages and breakpoints

Site Health runs a separate check for each breakpoint (Default, Tablet, Mobile, and so on).

Top of the Site Health panel with the page scope, breakpoint, and issue-type selectors highlighted

  1. Select the breakpoint you want to check from the breakpoint selector at the top of the panel.

  2. To see only the issues on the page you're viewing, select [Only this page].

  3. To see only one category of issues, choose it from the selector that shows [All].

Note: The list only shows issues for the selected breakpoint. If elements are shown or hidden differently by breakpoint, the issues also change. Before publishing, check the list for every breakpoint.

Go to a flagged element

Click an issue in the list to select the element on the screen.

  1. Click the issue you want to check in the list.

  2. The element is selected and shown on the screen.

You can select elements on other pages or inside components the same way. The page you're viewing switches automatically.

Check and apply fixes

Each issue shows what the problem is and suggested fixes.

Site Health issue selected, with suggested fixes displayed

  1. Select an issue in the list.

  2. The editor moves to the element automatically.

    1. Click the light bulb icon at the right end of the issue to see the suggested fixes.

  3. Follow the suggested fix and change the settings in the right panel or the Layers panel.

  4. Update your site from the Publish panel. Changes aren't reflected on your published site until you do this.

Updating the results

After you make a fix, Site Health automatically runs again. When the issue is resolved, it disappears from the list.

You can keep editing in the Design Editor while the check is running.

Related articles

Did this answer your question?