verbb / navigation

4.0.4 2026-10-04 21:22 UTC

Requires

• php: ^8.2
• craftcms/cms: ^5.9.11
• nystudio107/craft-plugin-vite: ^5.0.0
• verbb/base: ^3.0.19

Requires (Dev)

• craftcms/cms: ^5.9.11
• craftcms/generator: ^2.0.0
• pestphp/pest: ^3.8
• pestphp/pest-plugin: ^3.0
• vlucas/phpdotenv: ^5.6
• yiisoft/yii2-shell: ^2.0.3

proprietary

• Verbb

• menu
• cms
• navigation
• Craft
• craftcms
• craft-plugin

Published on Packagist.org on 2026-10-04 21:22 UTC

README

Important

Navigation 4 for Craft 5 has some breaking changes. Consult our Upgrading from v3 docs for the details.

Navigation for Craft CMS

Navigation is a Craft CMS plugin that gives content teams a dedicated place to build menus while developers keep control of the markup. Mix Craft elements and custom URLs, manage the hierarchy visually, and query or render the result through a consistent API.

Create as many navigations as the site needs and arrange their nodes independently of Craft's section structure. Element-backed nodes can follow changes to their destination while still allowing menu-specific overrides.

Features

• Model headers, footers, utility menus and other structures independently.
• Arrange deep menu hierarchies through a visual control-panel interface.
• Link entries, assets, categories, Commerce products and other supported elements.
• Include external sites, anchors and destinations that do not belong to a Craft element.
• Project entries, categories, assets or products into a menu at read time with conditions and ordering.
• Follow changes to a destination's title and status, with per-node overrides when needed.
• Manage navigation values and propagation across the project's sites.
• Add project-specific content to menus and individual nodes through separate Craft field layouts.
• Arrange and edit menu content without changing the live tree until the work is published.
• Work with navigation nodes through familiar Craft element queries.
• Generate a complete menu or render every element with project-owned templates.
• Build breadcrumb data from the current URL and navigation structure.
• Retrieve siblings, branches and ancestors, and identify the current or active path without rebuilding the tree in templates.
• Cache trees with tagged invalidation and opt into linked-element or hierarchy hydration when a template needs it.
• Add support for custom element types through the plugin's extension points.
• Query navigations and nodes for decoupled front ends.
• Move menus through JSON, import nodes with Feed Me or migrate from supported navigation plugins.

Documentation

Visit the Navigation Plugin page for all documentation, guides, pricing and developer resources.

Support

Get in touch with us via the Navigation Support page or by creating a Github issue