Skip to main content
New: 190 SEO checks now available. See what's new
mediumAccessibilityMISSING_ARIA_LABEL_ON_ICON_BUTTON

Icon-only button missing aria-label — the fix

One or more buttons contain only an icon (SVG, icon font, or image) with no text or aria-label to describe their function. Screen readers cannot determine the button's purpose.

Where this fits: accessibility in SEO

Accessibility overlaps heavily with SEO because both depend on machine-readable structure: alt text, heading hierarchy, labels, contrast. Screen readers and search crawlers consume the same signals. Accessible sites rank better not by special treatment but because the same fixes — descriptive alt attributes, proper headings, real link text — are exactly what search engines parse for meaning. It is also, in a growing number of jurisdictions, the law.

Why icon-only button missing aria-label hurts your rankings

Icon-only buttons are extremely common in modern UIs (hamburger menus, close buttons, search icons), but without aria-labels, they are completely opaque to screen reader users. This is a WCAG 2.1 Level A violation and one of the most common accessibility issues on the web.

This is a medium-severity issue: individually modest, but it compounds — dozens of medium issues across hundreds of pages add up to a real quality deficit in how search engines assess the site.

How to fix it

Add an aria-label attribute to each icon-only button that describes its action. Use verbs that match the button's function (e.g., 'Open menu', 'Close', 'Search').

<button aria-label="Open navigation menu">
  <svg><!-- hamburger icon --></svg>
</button>

Accessibility best practices

  • Give every informative image an alt attribute that describes its content; decorative images get alt="".
  • Maintain heading hierarchy — never skip levels for styling reasons.
  • Make link text meaningful out of context; screen readers list links in isolation.
  • Keep text contrast at WCAG AA (4.5:1) minimum.
  • Make everything keyboard-operable with a visible focus state.

The full library: SEO best practices, by category.

Frequently asked questions

What does "Icon-only button missing aria-label" mean?

One or more buttons contain only an icon (SVG, icon font, or image) with no text or aria-label to describe their function. Screen readers cannot determine the button's purpose.

Why does icon-only button missing aria-label matter for SEO?

Icon-only buttons are extremely common in modern UIs (hamburger menus, close buttons, search icons), but without aria-labels, they are completely opaque to screen reader users. This is a WCAG 2.1 Level A violation and one of the most common accessibility issues on the web.

How do I fix icon-only button missing aria-label?

Add an aria-label attribute to each icon-only button that describes its action. Use verbs that match the button's function (e.g., 'Open menu', 'Close', 'Search').

How serious is this issue?

This is a medium-severity issue: individually modest, but it compounds — dozens of medium issues across hundreds of pages add up to a real quality deficit in how search engines assess the site. It belongs to the accessibility family of checks.

How do I find every page affected by this on my site?

Run a free Dr Urls audit: it crawls your site, detects icon-only button missing aria-label on every affected page, shows example URLs, and generates a ready-to-use fix task. Re-scan after fixing to verify the issue is gone.

Does your site have this issue?

A free Dr Urls audit crawls your site, finds every page affected by icon-only button missing aria-label, and hands you a ready-made fix task.

Check my site free

Related accessibility guides