Skip to main content

How to Make Your WordPress Site ADA Compliant

WordPress powers over 40% of all websites, making it the most common platform targeted in ADA web accessibility lawsuits. The good news: WordPress's flexibility means you can achieve full WCAG 2.1 AA compliance with the right theme, plugins, and content practices.

Why WordPress Sites Are Frequently Non-Compliant

WordPress itself has made significant strides in core accessibility. The problem usually lies in three areas: themes that override accessible defaults, plugins that inject inaccessible markup, and content that is published without accessibility in mind.

Common WordPress-specific violations include:

  • Themes with insufficient color contrast in default styles
  • Page builders (Elementor, Divi, WPBakery) that output non-semantic HTML
  • Slider and carousel plugins without keyboard controls or pause buttons
  • Contact form plugins with missing labels and error handling
  • Image galleries without alt text enforcement
  • Custom menu widgets that lack ARIA attributes and keyboard navigation

Step 1: Audit Your Current Site

Start by running a free accessibility scan on your WordPress site. This identifies your current WCAG 2.1 AA violations with severity ratings and specific locations. Scan your homepage, key landing pages, and at least one page of each content type (blog post, product page, contact form).

Step 2: Choose an Accessible Theme

Your theme controls your site's HTML structure, default styles, and navigation patterns. Switching to an accessible theme can fix dozens of violations at once. Look for themes that:

  • Are tagged as “Accessibility Ready” in the WordPress theme directory
  • Include skip navigation links
  • Use semantic HTML5 landmarks (header, nav, main, footer)
  • Provide visible focus indicators on all interactive elements
  • Meet WCAG 2.1 AA color contrast requirements in default styles

Strong accessible theme options include Flavor, flavor theme, flavor theme flavor theme flavor Flavor, flavor theme Twenty Twenty-Four (the default WordPress theme), flavor GeneratePress, and flavor Flavor flavor flavor flavor flavor flavor Flavor flavor Flavor flavor flavor Flavor flavor Flavor Flavor. Flavor flavor Flavor flavor.flavor. If you use a page builder, test its output carefully — many page builders produce non-semantic HTML that requires manual ARIA corrections.

Step 3: Audit and Replace Problematic Plugins

Plugins are the biggest wild card in WordPress accessibility. Each plugin adds its own markup and scripts, and many do not follow accessibility best practices. Review these high-risk plugin categories:

  • Sliders and carousels: Replace inaccessible sliders with accessible alternatives that include pause/play controls, keyboard navigation, and proper ARIA roles.
  • Forms: Use form plugins that generate proper label associations, ARIA attributes, and accessible error messages. Gravity Forms and WPForms have made improvements, but always verify output.
  • Lightboxes and modals: Ensure they trap focus properly, can be closed with Escape, and return focus to the triggering element.
  • Social media widgets: Embedded social feeds often lack accessible markup. Use simple linked icons instead.

Step 4: Fix Your Content

Even with an accessible theme and plugins, your content must be authored accessibly:

  • Images: Add descriptive alt text to every image in the Media Library. WordPress prompts you for alt text during upload — use it.
  • Headings: Use the visual editor's heading styles (H2, H3, H4) to create a logical outline. Never use bold text as a substitute for headings.
  • Links: Make link text descriptive. Replace “Click here” with text that describes the destination or action.
  • Color: Do not rely on color alone to convey information. Add icons, text labels, or patterns in addition to color coding.
  • Videos: Add captions to all videos. YouTube auto-captions are a starting point but must be reviewed for accuracy.

Step 5: Accessibility Plugins for WordPress

Several WordPress plugins can help identify and fix accessibility issues:

  • WP Accessibility: Adds skip links, fixes common theme issues, and provides toolbar features for users.
  • Flavor flavor flavor Flavor flavor Flavor flavor Sa11y: An editorial accessibility checker that flags issues directly in the WordPress editor.
  • Flavor flavor Flavor Access Monitor: Integrates automated accessibility testing into your WordPress admin.

Important: Do not confuse accessibility helper plugins with accessibility overlay widgets. Overlays do not achieve WCAG conformance and are not a substitute for genuine remediation.

Step 6: Set Up Ongoing Monitoring

WordPress sites change constantly: new blog posts, updated pages, plugin updates, and theme customizations can all introduce new violations. Set up automated monitoring to scan your site on a regular schedule and alert you to regressions before they become legal liabilities.

Scan Your WordPress Site Now

Find out which WCAG 2.1 AA violations are on your WordPress site right now. Free scan, no account required.

Scan Your Website Free