Skip to main content

WordPress fix guide

Fix ARIA mistakes on WordPress

Use ARIA sparingly; prefer native HTML.

Check your live page

Canonical issue page: ARIA mistakes

What this issue means

Guidance

Fix invalid combinations reported by automated tools; validate with browser accessibility inspectors.

How to fix on WordPress

In WordPress, fix the underlying theme or block output: child themes, block patterns, or plugin markup. Re-scan after updates—page builders often regress heading order or button names.

How to fix

Prefer native elements; validate custom widgets with browser a11y inspectors.

Remove invalid combinations reported by axe; retest with keyboard.

Related: 4.1.2 Name, Role, Value.

Other platforms

TestAccessibility · Programmatic fix page · localhost:3001