Website Spec
← Accessibility
Avoid

Accessibility overlays

Third-party JavaScript widgets that claim to make a site WCAG-compliant at runtime. They do not work, often harm screen-reader users, and attract lawsuits.

What it is

Accessibility overlays are third-party JavaScript widgets — AccessiBe, UserWay, EqualWeb, AudioEye, and similar — that you paste into a page with a single script tag. They promise to detect accessibility problems and fix them automatically at runtime, usually with a floating button that opens a panel of toggles for font size, contrast, and similar controls.

<!-- The shape of the problem -->
<script src="https://acsbapp.com/apps/app/dist/js/app.js"></script>

The marketing claim is that one line of code makes a site WCAG-compliant. It does not.

Why it matters

Overlays do not fix accessibility. They frequently make it worse:

The Overlay Fact Sheet, signed by more than 800 accessibility professionals including most of the field's recognised experts, recommends against them outright. WebAIM's survey of users with disabilities found that the large majority who had encountered overlays rated them as unhelpful or actively harmful.

What to do instead

Fix the underlying site. There is no shortcut, but the work is well-scoped:

Audit with a combination of automated and manual tools: axe DevTools, Lighthouse, WAVE, and the Equalize Digital Accessibility Checker for WordPress sites all catch a useful subset of issues. None of them replace manual testing with a real screen reader (VoiceOver on macOS or iOS, NVDA on Windows) and keyboard-only navigation. Fix issues incrementally and track them like any other defect.

Common mistakes

Verification

Sources