Skip to main content
NavShell is the root block of every gavAI page. This page explains what NavShell renders, when to choose topbar versus sidebar, and how it wraps every other section in the tree. Reach for it whenever you need a page with persistent navigation — almost every public marketing page and every authenticated dashboard. Only one NavShell exists per page, and it must sit at the root of tree.

​
Example

nav-shell.json
{
  "block": "NavShell",
  "props": {
    "logo_url": "https://cdn.acme.co/logo.svg",
    "brand_name": "Acme Co.",
    "items": [
      { "label": "Home", "href": "/" },
      { "label": "Pricing", "href": "/pricing" }
    ],
    "variant": "topbar"
  },
  "children": [
    { "block": "Hero", "props": { "headline": "Welcome to Acme" } },
    { "block": "Footer", "props": { "copyright": "© 2026 Acme Co.", "groups": [] } }
  ]
}

​
Props

​
Variants

Two variants cover the bulk of layouts:

​
Common props

In addition to the props above, NavShell accepts the four common props every block supports: id, class_overrides, visible_if, and analytics_event. See common props on the PageBlocks overview.

​
Where to go next