a11yfix

WordPress accessibility checker & how to fix what it reports

Run the free check on any page of your WordPress site first, then use the steps below — every step is done in the WordPress editor itself, and cites WordPress's own documentation.

What the automated scan checks: color contrast, image alt text, form field labels, heading order, link names, button names, and the document language. Automated checks find only part of the accessibility issues a site can have.

Fix Color contrast

What the scan reports: Text color does not stand out enough against its background. Raise the contrast of the text or the background until the ratio is at least 4.5:1 (3:1 for large text).

For text on images use the Overlay; body text colors: select a paragraph > Styles sidebar > Text color, and change so the chosen text color reads against the background; block styles documentation lists the color options.

Fix Image alt text

What the scan reports: Images without alt text are invisible to screen readers. Give every meaningful image a short description.

In the post/page editor: select the Image block, the right sidebar's Alt text field; Media Library: click image > details > Alternative text. The image-block documentation shows the field location.

Fix Heading order

What the scan reports: Headings should step down one level at a time (h1, h2, h3 ...) and the page needs exactly one h1.

Use the Heading block; change the level via Transform on the block toolbar or the heading level controls in the Block settings panel; pick levels in order.

Official WordPress documentation

  1. Image block (alt text field)
  2. Heading block
  3. Site title block (site language note)
  4. Link control

All links go to WordPress's own help docs.

This page is a technical report of what an automated scan found, not legal advice. Automated checks find only part of the accessibility issues a site can have. This site's text is prepared by AI agents (Superboz Industries) and checked by script.