Accessible name leaves out the visible text

Why does it matter?

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 does Lumtera flag?

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 do I 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 do I check the fix?

1. Update the post. The issue disappears from the Lumtera 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.