Glossary

What is Button names?

Also called: Accessible buttons

A button with only an icon, such as a menu symbol, has no name for a screen reader, which then says only "button". Visible text or a hidden name such as "Open menu" fixes this.

Why it matters

A button with no name is unusable for some visitors. EU accessibility rules may apply. Onbiom is not legal advice, and the check is a static homepage signal.

How Onbiom checks it

Onbiom's rule: we count every button, element with role button and image button on your homepage. A button counts as named if it has text inside, an aria-label, a title, a value or alt text, an image with alt text inside it, or an aria-labelledby that points to something on the page.

If any button has no name the check fails and tells you how many. If there are no buttons it does not apply. It is shown as Required if the site looks like a shop or takes bookings and Recommended otherwise. The result is reported apart from the visibility score.

In your report this appears as: Names on buttons.

How to check it yourself

  1. Look at each icon-only button on your homepage.
  2. Check that it has an aria-label or hidden text; your web person can inspect the page for this.

Not sure about your own site? Paste your address and see in a minute which of these checks your site passes. Free, no account needed.

Check your site

How to fix it

Any website
Put words inside each button. For icon-only buttons add an aria-label such as Open menu.
Ask your web person
Theme and plugin buttons often come without names, so a change in the theme may be needed.

Related terms

Sources and further reading

Last reviewed: