WordPress.org

Plugin Directory

Web Accessibility Toolkit – ARIA Labels & Roles for WCAG & ADA Compliance

Web Accessibility Toolkit – ARIA Labels & Roles for WCAG & ADA Compliance

Beschreibung

The Web Accessibility Toolkit helps your WordPress site meet ADA compliance and WCAG compliance standards with powerful accessibility checking and fixing tools.

This plugin is not an ‚overlay‘ or a ‚widget‘ – it provides real code fixes to assist with WCAG & ADA compliance for WordPress.

Scan your site with the built-in Accessibility Checker to identify issues such as missing ARIA labels, low contrast text, missing alt tags, incorrect heading structure & plenty more.

Apply one-click fixes for many common accessibility issues to improve usability and help meet requirements for laws and standards like WCAG, ADA, EAA, Section 508, EN 301 549, and AODA.

Documentation | Accessibility Checker Demo | PRO Plugin

Accessibility Checker

The built-in Accessibility Checker scans your WordPress site in real time to identify common accessibility issues that could affect WCAG compliance and ADA compliance. With a single click, you can run an accessibility check on any page and get clear, actionable details.

The checker highlights issues directly on the page, including:

  • Missing or empty ARIA labels
  • Low color contrast between text and background
  • Missing alt text on images
  • Skipped heading levels (e.g., jumping from H2 to H4)
  • Broken ARIA references
  • Interactive elements without keyboard focus
  • Improper tab order
  • Missing page titles
  • Duplicate link text with different destinations
  • Duplicate IDs in the DOM
  • Form fields without labels or ARIA labels
  • Use of user-scalable=no in viewport meta tags
  • Non-focusable interactive elements

Each issue includes details on what it means, why it matters for accessibility and how to fix it. Many problems can be resolved instantly using the plugin’s one-click fixes, while others provide guidance so you can address them in your theme or content.

Accessibility Fixes for WCAG & ADA Compliance

  • ARIA Attributes

    Add ARIA attributes such as aria-label, aria-hidden, aria-expanded, aria-live, aria-level, and more to any element.

  • ARIA Roles

    Assign semantic roles like banner, navigation, main, complementary, and contentinfo to improve screen reader navigation.

  • Image Alt Tags

    Shows a list of all images that are missing alt tags, and allows you to easily update them all from the one spot.

  • Contrast Adjustments

    Override text and background colors for low-contrast elements using accessible HEX values.

  • Skip Link Target

    Add a keyboard/screen-reader-visible “Skip to content” link by defining a main content selector.

  • Language Override

    Set or override the HTML lang attribute for improved screen reader compatibility.

  • Focus Outline Enhancements

    Ensure visible focus styles are enforced for better keyboard navigation.

  • Fix Tab Order

    Remove tabindex values greater than 0 to maintain a logical focus order.

  • Make Viewport Scalable

    Remove user-scalable=no from the viewport meta tag to allow pinch-zooming.

  • CSS Selector-Based Targeting

    Use any valid CSS selector to apply changes without modifying theme or template files.

Why Use Web Accessibility Toolkit?

Most WordPress themes don’t include full accessibility support. Web Accessibility Toolkit lets you patch those gaps quickly, keeping your site more inclusive and compliant with ADA & WCAG guidelines.

Whether you’re a developer working on a client site or a business owner aiming for better usability, this plugin makes accessibility updates faster and easier.

The Web Accessibility Toolkit is NOT an overlay widget, which can often do more harm than good for accessibility. This plugin fixes underlying code issues.

Compatibility

  • Compatible with all WordPress themes
  • Compatible with all WordPress plugins
  • Works alongside popular page builders
  • Designed with WCAG 2.1 AA standards and ADA compliance in mind

Screenshots

  • The General Settings section – configure general accessibility options
  • The ARIA attributes section – configure ARIA attributes options
  • The Roles section – configure landmark roles options
  • The Contrast section – configure contrast accessibility options
  • The frontend accessibility scanner – check your site for accessibility issues
  • The Images section – update alt tags on your images

Installation

Using the WordPress Dashboard

  1. Navigate to “Add New” in the plugins dashboard
  2. Search for “Web Accessibility Toolkit”
  3. Click “Install Now”
  4. Activate the plugin on the Plugin dashboard
  5. Go to Settings > Web Accessibility to start configuration

Uploading in WordPress Dashboard

  1. Click the download button on this and save “aria-accessibility-toolkit.zip” to your computer
  2. Navigate to “Add New” in the plugins dashboard
  3. Navigate to the “Upload” area
  4. Select “aria-accessibility-toolkit.zip” from your computer
  5. Click “Install Now”
  6. Activate the plugin in the Plugin dashboard
  7. Go to Settings > Web Accessibility to start configuration

Using FTP

  1. Download the Web Accessibility Toolkit ZIP file
  2. Extract the Web Accessibility Toolkit ZIP file to your computer
  3. Upload the “aria-accessibility-toolkit” directory to the /wp-content/plugins/ directory
  4. Activate the plugin in the Plugin dashboard
  5. Go to Settings > Web Accessibility to start configuration

FAQ

What does this plugin do?

Web Accessibility Toolkit scans your site with an accessibility checker and helps you fix ADA compliance and WCAG compliance issues. It lets you add ARIA attributes, landmark roles, adjust contrast, fix alt tags, and more — no coding required.

Can this help my WordPress site be ADA compliant?

Yes. While no plugin alone guarantees compliance, this tool helps you meet several key WCAG 2.1 success criteria like semantic structure, sufficient contrast, and accessible navigation.

Does it work with any theme?

Yes. The plugin is designed to work with any WordPress theme, including those built with page builders like Elementor, WPBakery, or Gutenberg.

Will it slow down my site?

No. It’s lightweight and only outputs a small block of CSS (and optionally JavaScript) based on your settings. There’s no third-party code or unnecessary overhead.

Can I use it without JavaScript?

Sort of. The plugin uses CSS & PHP where possible. JavaScript is used for the accessibility checker and dynamic updates that can’t be done with CSS alone.

What kind of selectors can I use?

Any valid CSS selector is supported — including classes (.my-button), IDs (#main-header), or element types (nav, section, etc.).

Can I apply multiple ARIA attributes to the same element?

Yes. Simply add another row targeting the same selector with a different ARIA attribute.

What is the accessibility checker for?

It shows a small box on your site (for admin users only) highlighting common accessibility issues like empty buttons, missing labels, broken ARIA references and low contrast.

What does the “Skip Link” setting do?

It adds a screen-reader-visible “Skip to content” link at the top of the page for keyboard users. Just define the CSS selector of your main content area.

What does the Language option do?

It sets the lang attribute on your <html> tag — especially useful if your theme doesn’t already do this.

How does the Accessibility Checker work?

There is an option in the admin to enable the Accessibility Checker and once enabled, admins will see a small box on the frontend of your website with a Scan Page button. Simply click this to start the accessibility scan and a list of issues will be displayed with details on how to fix them.

What are the full list of features?

The Web Accessibility Toolkit plugin provides tools to help improve frontend accessibility, scan for issues, and add missing ARIA roles, labels, and other enhancements.

Free Version Features:

  1. Frontend Accessibility Checker panel
  2. Scan for missing aria-label and aria-labelledby attributes
  3. Detect and highlight empty buttons or ARIA attributes
  4. Detect broken ARIA references (e.g. aria-describedby targets not found)
  5. Detect low color contrast issues (text vs background)
  6. Detect skipped heading levels (e.g. jumping from h2 to h4)
  7. Detect missing alt text on images
  8. Detect form fields without labels or ARIA labels
  9. Detect duplicate link text with different destinations
  10. Detect use of user-scalable=no in viewport meta tag
  11. Detect missing page title
  12. Detect duplicate IDs in the DOM
  13. Detect use of tabindex values greater than 0
  14. Detect non-focusable interactive elements
  15. Live preview: „Show“ and „Copy Selector“ buttons for each issue
  16. Fix suggestions for supported issues via plugin settings page
  17. ARIA role injection via CSS selectors
  18. Add landmark roles like navigation, main, banner, and more
  19. Add aria-label to menu items or custom HTML elements
  20. Set default lang attribute on the HTML tag
  21. Add skip link anchor to improve keyboard navigation
  22. Disable animations for motion-sensitive users
  23. Enable high-contrast mode support (coming soon)
  24. Lightweight, modular design — only loads what’s needed

PRO Version Features:

  1. Form scanning
  2. Automatic form fixes
  3. Unlimited menu targeting for ARIA attributes
  4. Unlimited menu targeting for ARIA roles
  5. Full list of selectable ARIA attributes
  6. Full list of selectable landmark roles
  7. Open External Links in New Tab
  8. Force Underline on Text Links
  9. Mark Decorative Images

Note: Not all issues can be automatically fixed. Some must be addressed in your theme or content. A full accessibility audit is recommended.

Is there a Pro version?

Yes! A Pro version unlocks unlimited menu targeting and advanced attribute/role options. Visit wcagforwp.com to learn more.

Rezensionen

There are no reviews for this plugin.

Mitwirkende & Entwickler

„Web Accessibility Toolkit – ARIA Labels & Roles for WCAG & ADA Compliance“ ist Open-Source-Software. Folgende Menschen haben an diesem Plugin mitgewirkt:

Mitwirkende

Änderungsprotokoll

1.5.9 (2025-11-17)

  • Update user-scalable option to also remove maximum-scale which allows full pinch zooming.

1.5.8 (2025-10-10)

  • Add review popup notice.

1.5.7 (2025-10-07)

  • Add new options available in PRO – Open External Links in New Tab, Force Underline on Text Links, Mark Decorative Images

1.5.6 (2025-09-27)

  • Add new ARIA Label field in menus, rather than relying on title. Still uses title as fallback if menu is selected.
  • Fix issue with notices being squashed

1.5.5 (2025-08-26)

  • Fix fatal error when no menu selected in ARIA tab

1.5.4 (2025-08-08)

  • Updates to the image alt tags tab

1.5.3 (2025-08-06)

  • Update frontend accessibility checker with errors and warnings
  • Add new error definitions to accessibility scanner
  • Add filter for showing frontend checker

1.5.2 (2025-08-05)

  • Update frontend accessibility checker with Level, links to the WCAG page and cleaner style

1.5.1 (2025-08-04)

  • Add links to leave a review

1.5.0 (2025-07-31)

  • Major styling update

1.4.2 (2025-07-29)

  • Add new bulk buttons to Image Alt option
  • Add Forms tab
  • Refactor WCAG frontend checker
  • Styling updates to frontend accessibility checker

1.4.1 (2025-07-11)

  • Fix issue with nav_menu_link_attributes filter only passing 3 args
  • Minor CSS fixes
  • Minor bug fixes to frontend accessibility checker

1.4.0 (2025-07-10)

  • Add „Image Alt Tags“ option

1.3.1 (2025-07-09)

  • Add „Fix Tab Order“ option
  • Add „Make Viewport Scalable“ option
  • Refactor frontend accessibility checker options & update help text
  • Add FIX buttons to frontend accessibility checker

1.3.0 (2025-07-07)

  • Add frontend accessibility checker
  • Add „skip link“ option
  • Add „HTML language override“ option
  • Add „focus outline“ option

1.2.1 (2025-07-05)

  • Minor bug fixes

1.2.0 (2025-07-04)

  • Add new General Options
  • General bug fixes and prefixing options
  • Correctly enqueue admin JS

1.1.0 (2025-07-01)

  • Naming updates

1.0.1 (2025-06-11)

  • Add all ARIA options to ARIA tab

1.0.0 (2025-06-11)

  • Initial Release