01
Merchandise the navigation in Magento
Mark categories as mega menus, choose a column layout and attach a promotional CMS block and navigation icon. Keep the menu structure close to the catalogue.
Magento 2.4.9
Headless Ready
Astro Storefront Required
INCLUDED IN AGENTICSUITE
NavBridge Pro for Headless Magento
Give your headless storefront richer navigation data. Configure mega-menu categories, columns, icons and promotional content in Magento, then render the menu in Astro.
Part of the complete platform.
This capability is included in AgenticSuite. Get the Astro storefront and all headless and Luma-compatible modules listed on this website.
Explore AgenticSuite Discuss your Magento projectYour platform. Your control.Full source code and your business data.
Built to work togetherAstro storefront and comprehensive Magento modules.
Check your requirements with us - Mega-menu metadata and category children
- Configurable columns, icons and CMS promotions
- Allow / deny lists and one structured query
BUILT AROUND THE WAY YOU WORK
Magento controls the menu. Astro brings it to life.
Included in AgenticSuite. This is part of a headless Magento implementation; the storefront and deployment must be configured to use it.
02
Render a structured menu in your storefront
Fetch menu metadata and children in one GraphQL query. Allow and deny lists help determine the categories your frontend renders.
A CLEAR WORKFLOW
From setup to everyday use.
- 01
Explore AgenticSuite and the live storefronts to see how the parts fit together.
- 02
Discuss your current Magento setup, integrations and requirements with our team.
- 03
Configure and test this capability as part of the agreed storefront project.
Do I need to buy this capability separately?+
AgenticSuite includes the Astro storefront and all headless and Luma-compatible modules listed on this website. Discuss the complete platform and your implementation scope with us.
Can you migrate my current store while it remains live?+
We can prepare and test a new storefront while the existing store keeps trading. Product, CMS and compatible module-data migration, final data synchronisation and cutover are planned for your specific project.
Does the licence include hosting and a bespoke build?+
Hosting, migration, training and custom development are agreed separately. We can discuss Cloudways for Magento and Cloudflare for the frontend; you can pay the providers directly or request a managed quotation.
Latest release: Version 1.0.3
NavBridge Pro is a Magento 2 module that adds mega-menu, column-count, promo CMS-block and icon controls to every category, and serves the whole navigation tree and mega-menu structure over GraphQL so a headless storefront can render a rich menu from one query.
Magento's GraphQL gives you categories, not a navigation
When you build a headless storefront, the main menu is one of the first things you have to recreate — and Magento's category GraphQL hands you a bare tree of names and URLs, nothing more. There's no concept of a mega menu, no column layout, no promotional panel, no icons. So every headless team rebuilds navigation logic from scratch and hard-codes it in the front end, where merchants can't touch it. NavBridge Pro fixes that: the rich menu structure lives in Magento, edited per category, and arrives in your front end as data.
Headless mega-menu · Per-category settings · 1–5 column layouts · Promo CMS blocks · Navigation icons · Allow / deny lists · One GraphQL query · Check release-specific Magento and PHP compatibility
| Mega menu per category | Flag any category as a mega menu and choose its column layout — from one to five columns. |
|---|---|
| Promo panels | Attach a CMS block to a menu so a featured banner or offer appears alongside the category links. |
| Icons & structure | Give categories navigation icons, and fetch the whole tree with levels, active state and children intact. |
| Decide what shows | Allow- or deny-list categories so the menu shows exactly what you want, not your entire tree. |
What you'll use it for
- Build navigation once — define the mega menu in Magento and let your Astro front end render it from data, not hard-coded markup.
- Let merchants own the menu — marketing can change columns, promo blocks and which categories appear without a front-end deploy.
- Feature offers in the menu — drop a seasonal CMS block into a mega menu so the navigation itself merchandises.
- Keep the menu tidy — exclude utility or hidden categories so only the right ones reach the front end.
How it works
Everything the front end needs, in one query
The whole menu comes back as structured data — no front-end guesswork. A single navBridgeMegaMenu query (or the broader navBridgeCategoryTree) returns each category with its mega-menu flag, column count, promo CMS block identifier and icon, alongside the standard name, URL path, level, active state and nested children. You can ask for mega-menu categories only, or the full tree to a chosen depth. Because the configuration lives on the category in Magento, your merchandising team edits the navigation — and a headless front end simply renders what the query returns.
Specifications
| Per-category settings | Mega-menu flag, column count (1–5), promo CMS block, navigation icon |
|---|---|
| GraphQL | navBridgeMegaMenu and navBridgeCategoryTree with root, depth and mega-only options |
| Returned data | Name, URL key/path, level, active state, include-in-menu, mega metadata and nested children |
| Visibility | Allow-list (only included) or deny-list (all except excluded) categories |
| Defaults | Store-wide default column count |
| Delivery & licence | Composer install, per-domain licence key, updates via Composer |
Works with
Part of the AgenticEcom suite for Headless & Astro:
Promo blocks come from the CMS Sync Bundle; pairs with Global Data Bundle for site-wide data. Included in the AgenticEcom Suite.
Frequently asked questions
What does this add over Magento's category GraphQL?
Magento's category query returns names, URLs and children. NavBridge Pro adds the mega-menu structure on top — a mega-menu flag, column layout, a promotional CMS block and an icon per category — so the front end can render a real mega menu instead of a plain list.
Can merchants change the menu without a deploy?
Yes. The settings live on the category in Magento, so your team can change columns, promo blocks, icons and which categories appear, and the headless front end reflects it from the next query — no front-end code change.
Can I show a promotional banner in the menu?
Yes. Attach a CMS block to a mega-menu category and its identifier is returned in the query, so the front end can render a featured panel alongside the links.
Can I control which categories appear?
Yes. Use an allow-list to include only chosen categories, or a deny-list to show everything except the ones you exclude.
Which Magento and PHP versions are supported?
Check release-specific Magento and PHP compatibility before installation.
SEE THE WHOLE PLATFORM
The capability is one part. AgenticSuite brings it together.
Keep Magento as your commerce engine. Shape the customer experience in Astro Admin, with an integrated module collection behind it.
A complete B2B catalogue.
Explore SyncComms: approximately 1,000 products, guided finders, category filters and a quotation journey.
Explore SyncCommsMobile scores achieved.
See the dated mobile lab reports linked from our homepage, or test the live sites yourself. Results depend on the page and test conditions.
View the performance evidenceMake the move while you trade.
We can scope migrations, frontend rebuilds and new stores. Hosting, migration, training and custom development are agreed separately.
Discuss your projectYOUR NEXT STOREFRONT STARTS HERE
See what AgenticSuite could do for your business.
Explore the working sites, watch the overview, then talk to us about your catalogue and the store you want to build.