warningControls

Name every button

Buttons need visible text or an aria-label so agents know what action they trigger.

Score weight−10

Capability checkUnderstand every button

Icon-only buttons with no text, aria-label, or title fail “Understand every button.” The agent sees a control it cannot name and skips the action entirely.

How to fix it

Naming a close button

<!-- before -->
<button><svg>…</svg></button>

<!-- after -->
<button aria-label="Close">X</button>

Prefer visible text when it fits the design; use aria-label only when space is genuinely constrained.

See if your page fails this rule.

The audit runs every documented check and reports the ones that fail, with fixes.

Run your first audit