WP Accessibility
WP Accessibility Plugin Review: What Joe Dolson's Free WordPress Plugin Fixes (and What Still Needs Theme Code)
Verdict
WP Accessibility (maintained by WordPress Core Accessibility team contributor Joe Dolson) is the rare WordPress accessibility plugin we recommend with confidence, earning an 86/100 baseline when paired with a typical theme. Because it fixes real HTML defects (adding skip links, html lang attributes, focus outlines, and removing target="_blank" traps) without claiming instant legal immunity, it serves as an honest companion to theme-level CSS and content remediation.
- Critical / serious
- 0 / 1
- Moderate / minor
- 0 / 0
- Keyboard
- Partial
- Overlay script
- None
axe-core rules triggered: color-contrast · Scanned
Key findings
- Zero False Promises: Explicitly documents that no plugin can magically make an arbitrary WordPress theme 100% WCAG compliant.
- Real Structural Repairs: Injects a working skip-to-content link, enforces language attributes, removes redundant title attributes, and adds visible :focus outlines where themes stripped them.
- Editorial Guardrails: Helps authors spot missing image alt attributes and low-contrast combinations inside WordPress.
- What Still Needs Theme Code: Cannot rewrite hardcoded low-contrast CSS tokens (#8E9AAF captions scored a Serious contrast violation in our specimen), untagged PDF uploads, or custom page-builder div modals.
Breakdown
| Issue Category | Handled by WP Accessibility? | What You Still Must Do |
|---|---|---|
| Missing Skip-to-Content Link | Yes (configurable target ID) | Verify #main-content ID exists on every template |
| Stripped Keyboard Focus Rings | Yes (optional outline enforcement) | Tune :focus-visible color for >= 3:1 contrast in dark sections |
| Low-Contrast Theme Palette | Tester tool included; CSS is yours | Update theme customizer / CSS variables to >= 4.5:1 |
| Untagged PDF Menus & Forms | No | Convert PDFs into native WordPress HTML pages and forms |
Failing markup and the fix
/* Theme stylesheet overrides muted text below 4.5:1 */
.entry-meta, .wp-caption-text {
color: #8e9aaf; /* 2.84:1 on #ffffff - fails WCAG 1.4.3 */
}:root {
--ink-muted: #475569; /* 7.58:1 on #ffffff - passes WCAG 1.4.3 AA & AAA */
}
.entry-meta, .wp-caption-text {
color: var(--ink-muted);
}Why does WP Accessibility succeed where commercial overlay widgets fail?
Commercial overlays charge $490 to $1,490 per year while encouraging site owners to leave broken theme markup in place behind a floating toolbar. WP Accessibility is free, open-source, disables its optional toolbar by default in modern configurations, and targets concrete WordPress output flaws documented by the WordPress Accessibility Team.
How should WordPress agencies pair WP Accessibility with automated regression checks?
Install WP Accessibility to lock in skip links, language declarations, and focus outlines, then run Deque axe-core against your staging URLs to catch palette contrast failures, unlabeled Gravity Forms / Contact Form 7 inputs, and editor-uploaded images missing alt text.
Questions
Should I turn on the font-size/contrast toolbar inside WP Accessibility?
Keep the floating toolbar off unless your audience specifically requests it; fix your base font size (>= 16px) and native color contrast (>= 4.5:1) directly in your theme stylesheet instead.
Has a vendor release fixed something above? Request a free re-test or read how we test.