Button has no text

Why it matters

A button with no name is announced as just "button". Icon-only buttons — close, menu, search, play — are the usual cause.

Who it affects: Screen reader users who browse by a list of links, keyboard users, and people using voice control who say a link's words to click it.

30.6% of the top million home pages had empty buttons in 2026. WebAIM Million 2026

What Lumtera flags

<button> elements, input buttons and role="button" elements with no text, value, alt or aria-label.

Check ID button-no-name — use it to filter the content report or with wp lumtera issues --rule.

How to fix it in WordPress

Add visible text to the button that says what it does. For icon-only buttons, add an aria-label such as aria-label="Close menu".

Example

<button class="close"><svg aria-hidden="true">…</svg></button>

<button class="close" aria-label="Close menu"><svg aria-hidden="true">…</svg></button>

How to check your fix

1. Update the post. The issue disappears from the Accessibility sidebar on the next check, and from the site report on the next scan.
2. Press Tab through the page. Every link and button should receive visible focus, and its text should make sense read on its own.