=== ARIA & Accessibility Checker + ARIA Labels, Attributes & Roles === Contributors: quicksnail Tags: a11y, accessibility, aria, wcag, web accessibility Requires at least: 5.9 Tested up to: 6.8 Requires PHP: 7.0 Stable tag: 1.4.2 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Make your website more accessibile with ARIA attributes & labels, landmark roles, alt tags & more. Scan with the accessibility checker for WCAG. == Description == [Documentation](https://wcagforwp.com/docs/) | [PRO Plugin](https://wcagforwp.com/downloads/pro-plugin/) **ARIA & Accessibility Toolkit** makes it easy to improve your WordPress website accessibility. The plugin includes an accessibility checker that scans for many common accessibility issues, and provides useful tools for you to able to fix these issues, which can help your site comply with digital accessibility standards and laws such as WCAG, ADA, Section 508, EN 301 549 and AODA. **Accessibility features at a glance**: - Accessibilty Checker - scan your site for issues - ARIA Attributes - easily add aria-label and other attributes - Landmark Roles - easily add landmark roles - Image Alt Tags - quickly add missing alt tags to images - Contrast Ratio - adjust contrast ratio of individual items - One-click Fixes - single click fixes for outlines, tab order, viewports & more - Targeted - fix various issues by targeting with CSS selectors ### Available Accessibilty Fixes - **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. - **Frontend Accessibility Checker** Enable a visual overlay to identify common accessibility issues (admin-only). - **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. These features help to address many common accessibility issues, but also, a warning: There are many accessibility issues that cannot be fixed by patching them with a plugin. If your WordPress theme is built with accessibility in mind, then your site may only require a few tweaks to bring it up to compliance - this is where the ARIA & Accessibility Toolkit could work great for your site. ### Why Use ARIA & Accessibility Toolkit? Most WordPress themes don’t include full accessibility support. ARIA & Accessibility Toolkit lets you patch those gaps quickly, keeping your site more inclusive and compliant. 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. ### Compatibility - Compatible with all modern WordPress themes - Works alongside popular page builders - Designed with WCAG 2.1 AA standards in mind == Frequently Asked Questions == = What does this plugin do? = ARIA & Accessibility Toolkit lets you add ARIA attributes such as aria-label, roles such as role="navigation", contrast fixes, language settings, and more to your site - no code editing required. = Can this help me pass WCAG or accessibility audits? = 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 frontend 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 frontend checker for? = It shows a small box on your site (admin-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 `` tag — especially useful if your theme doesn’t already do this. = What are the full list of features? = The ARIA & 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 1. Automatic form fixes 1. Unlimited menu targeting for ARIA attributes 1. Unlimited menu targeting for ARIA roles 1. Full list of selectable ARIA attributes 1. Full list of selectable landmark roles Note: Not all issues can be automatically fixed. Some must be addressed in your theme or content. = Is there a Pro version? = Yes! A Pro version unlocks unlimited menu targeting and advanced attribute/role options. Visit [wcagforwp.com](https://wcagforwp.com) to learn more. == Installation == ### Using the WordPress Dashboard 1. Navigate to “Add New” in the plugins dashboard 2. Search for “ARIA & Accessibility Toolkit” 3. Click “Install Now” 4. Activate the plugin on the Plugin dashboard 5. Go to Settings > ARIA Toolkit 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 > ARIA Toolkit to start configuration ### Uing FTP 1. Download the ARIA & Accessibility Toolkit ZIP file 2. Extract the ARIA & 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 > ARIA Toolkit to start configuration == Screenshots == 1. The General Settings section - configure general accessibility options 2. The ARIA attributes section - configure ARIA attributes options 3. The Roles section - configure landmark roles options 4. The Contrast section - configure contrast accessibility options 5. The frontend accessibility scanner - check your site for accessibility issues 6. The Images section - update alt tags on your images == Changelog == = 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