Accessible name leaves out the visible text

Why it matters

An aria-label replaces a link or button's visible text for assistive technology. If it leaves those words out, a voice-control user who says "click Subscribe" gets no match.

Who it affects: Screen reader and keyboard users, who depend on ARIA and focus order being correct to understand and operate the page.

What Lumtera flags

Links and buttons whose aria-label does not contain their visible text.

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

How to fix it in WordPress

Change the aria-label so it contains the visible words, ideally at the start: for a button showing "Subscribe", use "Subscribe to our newsletter", not "Sign up". Often the simplest fix is to remove the aria-label altogether (in the block editor, use the block's "Edit as HTML" option, or the label setting of the plugin that added it) and let the visible text be the name.

Example

<button aria-label="Sign up">Subscribe</button>

<button aria-label="Subscribe to our newsletter">Subscribe</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 from the top of the page. Focus should move in reading order and never land on something invisible or silent.