Changelog

Name: Verbb
Address: 552 Victoria Street, North Melbourne, Victoria, 3051, Australia
Telephone: +61399990776
Price range: $$

6.0.3 2026-10-16

Fixed migrated Craft and plugin icons retaining stale provider paths across environments. (navigation#475 (opens new window))

Fixed keyboard focus order, button semantics, and focus restoration for navigation item editors. (#158 (opens new window))

{warning} Before upgrading to Control Panel Nav 6, review the upgrade guide for breaking changes and required migration steps.

Added a new navigation builder with accessible drag-and-drop, keyboard controls, and inline editing for nested menu items.
Added live discovery of Craft and plugin navigation items, with default-position insertion, source refresh, and dismissible new-item notices.
Added a lightweight Project Config customization overlay that stores only administrator overrides using stable node keys.
Added portable custom SVG icons selected from the filesystem folder configured by Icons Path.
Added support for Craft aliases, environment variables, {site}, and {siteHandle} in manual URLs, with an allowlist for relative, http, https, mailto, and tel URLs. (#128 (opens new window))
Added a Duplicate action for layouts, including their permissions and navigation customizations. (#144 (opens new window))
Added cp-nav/migrate-customizations and cp-nav/audit-customizations console commands for reviewing and managing v5 navigation data.
Added events for modifying resolved navigation and responding to individual or complete customization changes.

Direct upgrades from Control Panel Nav 4 on Craft 4 and Control Panel Nav 5 on Craft 5 are supported. Existing navigation rows are migrated to the new Project Config customization format, with safe preview, audit, rerun, and replacement options available through the console commands.
Now requires Craft CMS 5.9 or later.
Now requires Verbb Base 3.0.20 or later to use the current control-panel asset bundle namespace without deprecation warnings. (verbb-base#3 (opens new window))
Custom icons now use relative SVG paths from Icons Path instead of Craft assets. Existing custom icons must be selected again after upgrading.
Control Panel pages no longer write Project Config while navigation is being read, and resetting a layout now returns it to the live Craft and plugin menu.
Layout selection for users in multiple groups now follows the order of layouts in the plugin. (#150 (opens new window))
General Settings now uses Control Panel Nav's page title, horizontal tabs, and breadcrumbs without a separate sidebar.
Updated divider styling for Craft 5 with a muted line-label-line treatment.

Removed the legacy Garnish navigation editor and custom Twig/MutationObserver sidebar replacement.
Removed the legacy cp-nav.navigations Project Config structure and active cpnav_navigation table; the table is archived as cpnav_navigation_v5_archive during upgrade.
Removed the Navigations and Service integration APIs and their navigation-record events. Use the new navigation builder, customization services, and events instead.