Skip to main content

WordPress fix guide

Fix Keyboard traps on WordPress

If focus cannot escape a component, keyboard users are stuck.

Check your live page

Canonical issue page: Keyboard traps

What this issue means

Fixes

On open, move focus to the dialog; on close, restore focus. Escape should close when appropriate.

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

On open, send focus to the first interactive control; on close, restore focus to the trigger.

Support Escape where users expect dismissal; document exceptions.

Related: 2.1.2 No Keyboard Trap.

Other platforms

TestAccessibility · Programmatic fix page · localhost:3001