CEB Menu ARIA
CEB Menu Aria adds an ARIA label field to WordPress menu items and applies it as an attribute in the rendered menu.
by Cary Briel · github.com/carybriel/ceb-menu-aria · website
Install
No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:
wp plugin install https://github.com/carybriel/ceb-menu-aria/archive/refs/heads/master.zipReadme
=== CEB Menu ARIA === Contributors: carybriel Tags: accessibility, aria, menus, navigation, a11y Requires at least: 5.8 Tested up to: 6.6 Stable tag: 0.1 License: MIT License URI: https://opensource.org/licenses/MIT
Adds an ARIA label field to WordPress menu items and applies it as an attribute in the rendered menu.
== Description ==
CEB Menu ARIA extends the WordPress menu editor by adding a new ARIA Label field for each menu item.
This makes it easier to build accessible navigation menus by assigning custom aria-label attributes to links in your menus. These labels help screen readers and assistive technologies provide better context for users with disabilities.
Features
- Adds a dedicated ARIA label input field to each menu item in the admin editor.
- Automatically saves and stores the ARIA label as menu item metadata.
- Outputs the
aria-labelattribute on the front end within the menu link<a>tag. - Lightweight, simple, and accessibility-focused.
Why use ARIA labels in menus?
ARIA labels improve accessibility by allowing developers to:
- Distinguish between multiple similar links (e.g., "Read more" buttons).
- Provide additional context for screen readers without changing the visible link text.
- Comply with WCAG guidelines for accessible navigation.
== Installation ==
- Upload the plugin files to the
/wp-content/plugins/ceb-menu-aria/directory, or install directly from the WordPress Plugins screen. - Activate the plugin through the 'Plugins' screen in WordPress.
- Go to Appearance > Menus, expand a menu item, and you’ll see a new ARIA Label field.
- Enter a label, save the menu, and the
aria-labelattribute will be added automatically to the menu link on the front end.
== Frequently Asked Questions ==
= Where does the ARIA label appear? =
It appears as an aria-label attribute inside the <a> element for the menu item link.
= Is this plugin theme-dependent? = No. It works with any theme that uses standard WordPress navigation menus.
= Will this affect SEO? = No. ARIA labels are for accessibility and have no negative impact on SEO. In fact, they can improve site usability.
== Screenshots ==
- The ARIA Label field in the WordPress Menu editor.
- Example of the
aria-labelattribute rendered in the front-end menu.
== Changelog ==
= 0.1 =
- Initial release with ARIA label field and attribute output.
== Upgrade Notice ==
= 0.1 = First public release.
== License ==
This plugin is licensed under MIT license