Directory / plugin
Maestro: The Inline Admin Menu Editor
v1.11.0 · by Dan Knauss
Hide admin menu items per user role, rename them, reorder them, swap their icons — an inline admin menu editor you drive right on the menu itself.
About this plugin
Maestro lets you orchestrate the appearance of the WordPress admin menu. Rename admin menu items, reorder them, change their icons, and hide admin menu items from the roles and people who don’t need them. Do it all within the admin menu directly with no separate settings screen.
Every WordPress install accumulates menu clutter. A dozen plugins each claim a top-level slot, submenus sit in an order nobody chose, and clients meet a dashboard full of tools that aren’t theirs. Maestro is how you customize the admin menu back into shape: declutter it for a client site, rename cryptic plugin labels into the words your team actually uses, reorder the admin menu so what you touch daily is at the top, and hide admin menu items per user role — or from one named person — so everyone sees only their own work.
Instead of a separate settings screen, Maestro turns the admin menu into something you edit in place — right where it lives. Toggle Edit Menu from the admin bar, and the menu becomes editable. Click a menu item to rename it, hide it from selected user roles, or change its icon. Drag submenu items and whole menu groups to reorder them. Nothing to configure first, and nothing to learn: the menu you are editing is the menu you are looking at.
And it stays out of the way. Maestro adds no autoloaded options and does no work at all on the front end, so a menu you tidied for the dashboard costs your visitors nothing (see Performance & footprint below).
Try Maestro right here. Launch a demo in WordPress Playground — it boots a throwaway site with the plugin active in edit mode, plus User Switching with a one-click admin-bar user switcher and named test users (Adam Admin, Emma Editor, Andy Author, Carrie Contributor, Steven Subscriber; password password) so you can try per-role visibility by switching to another user’s account.
What you can do — as a site administrator
Maestro’s enhancements are only activated for logged-in users with an Administrator role. They can:
- Rename any top-level or submenu item — just click the label.
- Reorder items by dragging (top-level items among themselves, submenu items within their parent), or with the keyboard (
Alt+Arrow). - Group the menu with separators: move or remove the existing ones, or add a new separator below any top-level item.
- Swap icons on top-level items. The icon picker offers all 342 Dashicons and 437 bundled Bootstrap Icons, grouped and searchable by admin topic, and on WordPress 7.1+ the icons in WordPress’s icon library, including any other plugins register. SVG icons take the menu’s colours in every admin colour scheme, just like a Dashicon. It accepts any of WordPress’s four native icon forms (dashicon, “none”, base64 image data-URI, or an image URL).
- Hide items from chosen roles — including administrators. All other roles at the top of the list ticks every role except your own in one step. Custom roles registered by other plugins (User Role Editor, Members, etc.) appear automatically.
- Hide items from specific people, by name, when a role is the wrong unit — one person on a shared role who doesn’t need a particular tool. Search for someone in the visibility popover and add them; a parent’s sub-items can be hidden per person too, with the parent left visible. Like every other hide in Maestro, this is cosmetic only: the page still loads by URL for anyone authorized to see it.
- Hide items from a named group of people with a visibility group — say “Reduced view” for the client’s staff. Make the group once under Visibility groups in the editing toolbar, add people to it, then tick it in any item’s visibility popover. Change who is in it later and every item it hides follows. A group is not a role: WordPress never sees it, and it grants or removes nothing. It is cosmetic only, like every hide in Maestro: the page still loads by URL for anyone authorized to see it.
- Widen the menu so longer labels fit on one line. Drag the menu’s edge while editing, or set an exact width under Settings (the gear in the editing toolbar). The width applies on every admin page, for everyone, on screens 961px and wider. If another plugin already sets the menu width, that plugin wins and Maestro tells you so.
- Preview the menu as a role. Press Preview as, choose a role, and the Dashboard shows that role’s menu under a read-only banner. You stay signed in as yourself, and nothing is saved.
- Copy a menu to another site with export/import under Settings. Export a JSON file of names, icons, role rules, ordering, separators and menu width, then review it on the destination before anything changes. Rules for named people and visibility groups never leave the site.
- Reset a single item to its WordPress default, or reset everything at once.
Changes are global — one configuration applies to everyone. Your custom menu configuration is stored as a sparse delta (just the differences) layered over the menu WordPress builds on each load. Nothing is rebuilt or duplicated, so a reset simply removes the delta, and the original menu returns.
Important: visibility is cosmetic, not access control
Hiding a menu item only declutters the menu. The underlying admin page still loads for anyone who knows or types its URL if they’re authorized to see it. That’s because a page’s own registered capability is the true lock. Maestro operates on the menu (presentation), which is a different plane from authorization.
If you need to actually prevent access, pair Maestro with a capability manager like PublishPress Capabilities**. It’s menu-aware, and its Pro tier can block admin pages by URL.
The maestro_capability filter lets such a plugin hand editing rights to a custom capability instead of the default manage_options.
Accessibility and localization
The editor is keyboard-operable end to end — select with Enter/Space, reorder with Alt+Arrow, and every move and save is announced to screen
readers. Modified items carry a non-color indicator with screen-reader text, so their state is never indicated by color alone.
Maestro uses the maestro-menu-editor text domain and ships a translation template plus starter language packs for Spanish (es_ES), German (de_DE), Japanese (ja), French (fr_FR), Portuguese – Brazil (pt_BR), and Italian (it_IT). WordPress.org language packs override and extend these; native-speaker and WordPress Polyglots reviews are welcome.
Architecture (for developers)
Config— reads/writes/sanitizes a single option (maestro_config) holding only the deltas. Reset = delete the option; the natural menu returns automatically.Replay— on a lateadmin_menupass, applies rename/icon/visibility to the$menu/$submenuglobals and reorders submenus. Top-level order uses the corecustom_menu_order+menu_orderfilters. Resilient to missing slugs (orphans are skipped) and new items (appended at the end).Rest—maestro/v1/config(GET/POST/DELETE), capability-gated,X-WP-Nonce.- The editor JS is driven by a localized model (with DOM ids), not DOM scraping, and diffs against captured pristine defaults so the stored config stays sparse.
- Localized editor labels are passed from PHP to JavaScript in
maestroData.i18n; the runtime zip includes the bundled POT template and starter catalogs.
Performance & footprint
Unlike other admin menu editors, Maestro won’t hurt your site’s performance. It’s small enough that there is nothing to compress, optimize, or tune.
Maestro is built to stay out of the way:
- Nothing added to
alloptions— the one that matters. WordPress loads every autoloaded option into memory on every request that boots it, including front-end pages served to logged-out visitors. A menu configuration is admin-only data, so an autoloaded one is a tax on traffic that will never read it — and a bloated autoloaded bundle is a classic cause of a sluggish site. Maestro’s option is explicitly non-autoloaded. Check it on your own site:wp option list --autoload=onwill not listmaestro_config. - Zero extra database queries on the front end. Not merely “light” — inert. Every hook is admin-gated, so a public page load reads nothing at all.
- One extra query on an admin page — a single, non-autoloaded option (
maestro_config), read once per request and cached, no matter how many parts of the plugin ask for it. With a persistent object cache (Redis / Memcached) that drops to zero. This is a deliberate trade: one query where the data is actually used, so that public traffic — the bulk of what a live site serves — pays nothing. - A wider menu costs one CSS rule. If you set a menu width, admin pages get one small inline style and no extra query. A site that never sets one gets nothing.
- Storage tracks your edits, not your plugin count. Maestro stores a sparse delta: three renamed items are three renamed items, whether the site runs five plugins or fifty. A typical configuration is 5–15 KB, with a hard 1 MB ceiling.
- Minimal storage. One
wp_optionsrow, created only when you first save a change — a fresh install stores nothing. No custom tables, no post or user meta, no transients, no cron jobs. Uninstalling deletes that single row. - Measured, not asserted. At a typical configuration size Maestro adds roughly 0.1 ms to an admin page load; even a pathological config at the 1 MB ceiling adds about 1 ms. Menu changes are applied in memory during the
admin_menupass, not through extra queries. Method and full numbers: config size vs. page-load cost. - Small install — roughly a 290 KB download. Nearly a third of that is the Bootstrap Icons set, which the editor fetches only when you first open its tab in the icon picker.
(Size figures are a v1.10.0 snapshot; timings were measured 2026-08-03 on WordPress 7.0 / PHP 8.3.)
Known limits / deferred to v2
- Reparenting (moving an item between a top-level position and a submenu) is not included. Top-level items reorder among top-level items, and submenu items reorder within their current parent. Reparenting needs hand-splicing of the globals plus
parent_file/submenu_filehighlighting fixes — a known minefield, parked deliberately. - Separators are top-level only; WordPress has no submenu separator. Core also drops a separator that directly follows another one or ends the menu, so one placed there will not show.
- Renaming an item drops any core-appended count badge (e.g., pending comments) from that label, since the badge lives inside the title string.
- Submenu sort relies on items registering by the late
admin_menupass; a plugin that registers submenus on an unusually late hook may not be captured.
Credits
Bundled Bootstrap Icons are © The Bootstrap Authors, licensed under the MIT License. They are recoloured to WordPress
menu grey and stored as data-URIs in assets/icons-bootstrap.json; see bin/generate-bootstrap-icons.mjs.
Support This Plugin
If Maestro saves you time or brings you or your clients the joy of a tidy admin menu, you can support its ongoing maintenance through GitHub Sponsors.