Control Panel Nav is one of our oldest plugins. Craft added a modifyCpNav() hook in March 2015, and CP Nav arrived almost straight away, back when we were still releasing plugins under the S. Group name. Its job hasn't changed much since — tidy up Craft's sidebar. Rename a menu item, move it somewhere more useful, hide the things a client doesn't need, and add a few shortcuts of your own.
Keeping those changes intact while Craft and every plugin keep changing their own menus has always been the trickier bit. For version 6, we've rebuilt how that works from the ground up, along with a new builder that shows your navigation as a tree.
A New Navigation Builder
The old editor was built on Garnish, Craft's jQuery-based UI framework. Its replacement is built on Plugin Kit, with drag-and-drop that also works from the keyboard and inline editing for nested items. Reorder items, adjust sub-navigation and edit links with the whole menu in view.
All the controls you know are still here. Rename Craft and plugin items, hide links your team doesn't need, add shortcuts and organise things with dividers. Reordering and visibility changes save as you go, while item details have their own Save button. The feature tour walks through the rest.
A massive thanks to everyone who tried the beta and helped us get the builder into shape.
Only Your Changes Are Stored
Earlier versions stored a complete copy of Craft's navigation and kept it in sync. That worked, but every time Craft or a plugin changed its menu, CP Nav had to update its copy too, and that showed up as project config changes nobody had asked for.
Version 6 starts with Craft's live menu instead and applies your customisations on top, storing only what you've changed. Links and default icons follow updates from Craft and your plugins, while your labels, order and visibility choices stay where you put them. Items that are no longer available drop out of the menu.
When a plugin adds something new, it appears where Craft would normally put it, with a notice in the builder so you can review it. Keep it, move it or hide it without touching the rest of your menu.
Your customisations still travel between development, staging and production through Project Config, but opening the control panel no longer writes navigation changes back to it, so your Git history should be a lot quieter.
Duplicate Layouts and Set Their Priority
Layouts still give different teams their own sidebar, and now you decide which one applies when someone belongs to several groups. Previously that came down to the order the groups were created in, so version 6 lets you reorder the Layouts list to set their priority, and the first matching layout wins.
You can also duplicate a layout, including its customisations and group assignments, which is handy when new layouts start from a core one. Give the copy a name and adjust its assignments before putting it to work.
Aliases and Custom SVG Icons
Manual links can now use Craft aliases and environment variables, so a shortcut doesn't need a hard-coded address that's wrong on staging. The {site} and {siteHandle} tokens work too, for links that should follow the current site.
Custom icons have changed the most. Instead of picking a Craft asset, you point Icons Path at a folder of SVGs in your project and choose one in the item editor. Control Panel Nav stores the relative path in Project Config, so deploy the folder with your project and the same icon turns up in every environment. The catch is that the upgrade can't turn an old asset into a file path, so you'll need to pick your custom icons again after updating. Copy the SVGs into your icons folder first, and it's a few clicks per item.
The manual links and custom icon docs have the setup details.
Upgrading
Control Panel Nav 6 needs Craft 5.9 or later, and you can go straight to it from version 4 or 5. Your existing navigation is migrated to the new format, and there are console commands to preview and audit the migration if you'd like to check it first. The upgrade guide covers the icons, layout priority and the old PHP services (removed in 6, in case you'd built anything on them). As always, try it on staging before your live site.
Control Panel Nav 6 (opens new window) is available today for Craft 5, and it's free.