Buttons do not have an accessible name

Buttons do not have an accessible name

Appears in: Accessibility audits

When a button doesn't have an accessible name, screen readers and other assistive technologies announce it as button, which provides no information to users about what the button does.

How the Lighthouse button name audit fails #

Lighthouse flags buttons that don't have text content or an aria-label property:

Lighthouse audit showing buttons do not have an accessible name

The Lighthouse Accessibility score is a weighted average of all the accessibility audits. See the Lighthouse accessibility scoring post for more information.

How to add accessible names to buttons #

For buttons with visible labels, add text content to the button element. Make the label a clear call to action. For example:

<button>Book room</button>

For buttons without visible labels, like icon buttons, use the aria-label attribute to clearly describe the action to anyone using an assistive technology, for example:

This sample app relies on Google's Material icon font, which uses ligatures to convert the buttons' inner text to icon glyphs. Assistive technologies will refer to the aria-label rather than the icon glyphs when announcing the buttons.

See also Label buttons and links.

Resources #

Last updated: Improve article