Skip to main content

WordPress accessibility: what breaks and how to fix it

Around 43% of all websites

WordPress itself is reasonably accessible. Almost everything that fails on a WordPress site comes from the theme, the page builder, or a plugin, which is good news: fix it once in the right place and it clears across every page at once.

What actually breaks on WordPress

01The theme's colour palette

Low contrast is the single most common failure on the web, and on WordPress it almost always traces back to the global palette rather than individual pages. One site we scanned had 47 separate contrast failures from a single grey.

Where to fix it: Block themes: Appearance, Editor, Styles, Colors. Classic themes: Appearance, Customize, Colors.

02Header icon buttons

The mobile menu toggle, search toggle and cart icon are usually icon-only with no text, so a screen reader announces them as just 'button'.

Where to fix it: Most themes provide a screen-reader-text span for these. If yours does not, the label has to be added in header.php or through a repair plugin.

03Media library alt text

WordPress asks for alt text in a modal you have to open per image, so it gets skipped. Years of uploads accumulate with none.

Where to fix it: Media, Library, list view, then the Alternative Text field on each image.

04Social icon rows

Icon links with no text produce a list of links a screen reader reads as 'link, link, link'.

Where to fix it: The Social Icons block has a Label field per icon. Fill it in.

The encouraging part

Because the theme controls most of it, a WordPress site usually goes from failing to passing with a handful of changes rather than a page-by-page slog.

Find out which of these apply to you

The scanner detects that you are on WordPress and writes the repair steps for that setup. Free, about fifteen seconds, no signup.

Scan my page

Other platforms