FreeNav for Craft CMS
FreeNav Documentation
FreeNav is a free, full-featured navigation menu builder for Craft CMS 5. Build complex navigation menus with a drag-and-drop interface, conditional visibility rules, intelligent caching, ARIA accessibility, template presets, GraphQL queries, and REST API endpoints.
Getting Started
Welcome to the FreeNav documentation. Use the sidebar to navigate through the available guides.
Installation
Get FreeNav installed in your Craft CMS project.
Configuration
Render options, caching, ARIA settings, and presets.
Usage
Template rendering, manual iteration, breadcrumbs, GraphQL, and REST API.
Migration
Migrate from Verbb Navigation with one click.
Troubleshooting
Common issues and solutions.
Changelog
Release history and upgrade notes.
Key Features
- 7 node types — entry, category, asset, product (Commerce), custom URL, site, and passive
- Drag-and-drop — visual builder with unlimited nesting depth
- Conditional visibility — show/hide by logged-in state, user group, URL segment, entry type, or custom rules
- 6 template presets — default, dropdown, sidebar, breadcrumb, footer, mega menu
- Smart caching — per-menu TagDependency auto-invalidation
- ARIA accessibility — automatic aria-current, aria-expanded, aria-haspopup, and role attributes
- GraphQL — per-menu types with scoped read permissions
- REST API — JSON endpoints for menus, nodes, and breadcrumbs
- Multi-site — propagation methods: none, site group, language, all
- Import/Export — JSON-based menu export and import with UID resolution
- Migration from Verbb Navigation — one-click import of all navigations and nodes
- Project Config — full support for menu structure syncing across environments
