No visible keyboard focus

Why does it matter?

Keyboard users follow the focus indicator to know where they are on the page, the way mouse users follow the pointer. Themes and plugins often remove it with "outline: none" because it looks untidy on click, and give nothing in its place, so keyboard users press Tab and cannot see what they landed on.

Who it affects: Keyboard, screen reader and low-vision users — every visitor meets the page title, language, landmarks, keyboard focus, target sizes and zoom settings on every page.

What does Lumtera flag?

Found by the keyboard walk: in review mode's Keyboard tab, "Check keyboard access" focuses every stop the Tab key reaches (up to 300) and compares how it looks unfocused and focused: its own styles, its parent's, its label and neighbouring element, inner elements such as an accordion button's text, SVG icon fill and stroke, and its ::before and ::after. If nothing visible changes, it is for review, with any CSS rules that remove the outline listed as evidence; stops that look the same are grouped. Styles for :focus-visible are applied as a keyboard would see them; when that was needed and some stylesheets come from another site and cannot be read, it is a tip instead. A script that draws focus elsewhere can fool it, so confirm by pressing Tab.

Check ID page-focus-visible, as shown in review mode and saved results.

How do I fix it in WordPress?

Give links, buttons and form fields a clear focus style, and remove any "outline: none" or "outline: 0" rule that has no replacement. For example, add a:focus-visible, button:focus-visible { outline: 2px solid currentColor; outline-offset: 2px; } in Appearance → Customize → Additional CSS or the Site Editor's Styles. Then press Tab through the page and check you can always see which item has focus.

Example

.main-navigation a:focus { outline: none; }

.main-navigation a:focus-visible { outline: 2px solid currentColor; outline-offset: 2px; }

How do I check the fix?

1. Reload the page in review mode and run the Keyboard tab again (or Test menus and pop-ups for menus, dialogs and tabs). The finding disappears once the page passes.
2. Load the page and press Tab: a "Skip to content" link should appear first, and you should always see where focus is, even under a sticky header. Pinch-zoom on a phone, and check the browser tab shows a meaningful title.