Skip to main content

A control's spoken name does not match its visible text

label-content-name-mismatch

Some controls display one label but announce a different one to assistive software.

Who this affects

Voice control users above all, they say what they see, and nothing happens because the software is listening for different words.

Fix it in WordPress

Happens when an aria-label is added that differs from the button's visible wording. Match them, or drop the aria-label.

What the fix is, technically

Make the accessible name start with, or contain, the visible text.

Does your site have this problem?

Scan any page free and find out in about fifteen seconds. No signup, and nothing about your site is stored.

Check my page

Other common failures