WCAG 2.4.7 — Focus Visible — keyboard focus indicator not visible
People navigating your website with a keyboard (Tab key) can't see which link or button they've selected because the focus outline is invisible. This makes the site unusable for people who can't use a mouse, including many people with disabilities. Under ADA Title II, visible focus indicators are required.
Who Is Affected
Users who navigate with keyboards instead of a mouse, including people with motor disabilities, blind users using screen readers, users with tremors or limited dexterity, and anyone whose mouse has stopped working.
What This Means
When someone presses Tab to move through your website, there should be a clear visual indicator showing which link, button, or form field is currently selected. This is called the "focus indicator" — usually a colored outline or border around the active element.
Many websites accidentally remove these indicators with CSS rules like outline: none or outline: 0, making keyboard navigation impossible. Without visible focus, users can't tell where they are on the page or what will happen if they press Enter.
Fix: CMS / Theme
This is typically caused by CSS that removes the browser's default focus outline. The fix involves restoring or replacing focus indicators site-wide.
Check for the Problem
- Press Tab repeatedly on your homepage to navigate through links and buttons.
- If you can't see which element is focused, you have this issue.
- Check your theme's CSS files for rules containing
outline: none,outline: 0, or:focus { outline: none }.
Fix the CSS
In Joomla:
- Go to Extensions → Templates → Your Template → Edit Files
- Open your main CSS file (usually
template.cssoruser.css) - Find and remove or modify any rules that set
outline: noneon:focusstates - Add this CSS to ensure all interactive elements have visible focus:
a:focus,
button:focus,
input:focus,
textarea:focus,
select:focus {
outline: 2px solid #005fcc;
outline-offset: 2px;
}
In WordPress:
- Go to Appearance → Theme Editor or use your child theme's style.css
- Follow the same steps as Joomla to find and fix outline removal
- Add the focus indicator CSS above
Alternative for both platforms: If your theme has a customizer color option for focus states, use that instead of custom CSS.
Fix: Content Editor
Content editors typically can't fix this issue directly since it requires CSS changes. However, you can test for the problem:
- Use Tab to navigate through any forms, buttons, or links you've added to pages
- Report missing focus indicators to your web developer or IT team
- When requesting custom buttons or interactive elements, specify that they need visible focus states
Standard Reference
WCAG 2.1 Success Criterion 2.4.7 — Focus Visible, Level AA
Any keyboard operable user interface has a mode of operation where the keyboard focus indicator is visible.
Check if your government website has this issue
OctoComply scans your website and documents for WCAG 2.1 AA violations. The free tier covers up to 10 pages.
Run a Free Scan