
NavBridge Pro for Magento 2 — Headless Mega-Menu over GraphQL
NavBridge Pro gives a headless Magento 2 storefront the rich navigation Magento's GraphQL leaves out. Mark any category as a mega menu, set its column layout, attach a promotional CMS block and a navigation icon — then fetch the whole structured menu, with all its metadata and children, in a si…
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.
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 Enterprise bundle and the Astro frontend licences.
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?
Magento Open Source 2.4.9 and later 2.4.x, verified on PHP 8.4 and 8.5.

