Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/carybriel/ceb-menu-aria/archive/refs/heads/master.zipAdds 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