> Agent-readable docs index: /llms.txt. Download /docs.zip to grep all markdown files locally.

---
title: Navigation
description: Tabs, groups, pages, and anchors that structure your sidebar.
icon: panel-left
---

# Navigation

The `navigation` field in `docs.json` controls the sidebar, tab bar, and overall site structure. Holocron supports the same navigation shapes as Mintlify.

## Simplest form: flat groups

```json
{
  "navigation": [
    {
      "group": "Getting Started",
      "pages": ["index", "quickstart"]
    },
    {
      "group": "Guides",
      "pages": ["guides/auth", "guides/deployment"]
    }
  ]
}
```

This creates a single sidebar with two collapsible sections.

## Tabs

Tabs split the sidebar into multiple top-level areas. Each tab has its own set of groups:

```json
{
  "navigation": {
    "tabs": [
      {
        "tab": "Documentation",
        "groups": [
          { "group": "Overview", "pages": ["index"] },
          { "group": "Guides", "pages": ["guides/setup"] }
        ]
      },
      {
        "tab": "API Reference",
        "openapi": "openapi.json"
      }
    ]
  }
}
```

Clicking a tab switches the sidebar content. The tab bar appears below the navbar.

### Link-only tabs

A tab can be an external link instead of a content section:

```json
{
  "tab": "GitHub",
  "href": "https://github.com/example/docs"
}
```

## Nested groups

Groups can contain other groups for deeper hierarchy:

```json
{
  "group": "Authentication",
  "pages": [
    "auth/overview",
    {
      "group": "Providers",
      "pages": ["auth/github", "auth/google", "auth/email"]
    }
  ]
}
```

## Group options

| Field      | Type    | Description                                      |
| ---------- | ------- | ------------------------------------------------ |
| `group`    | string  | Section title in the sidebar                     |
| `pages`    | array   | Page slugs or nested groups                      |
| `icon`     | string  | Icon displayed next to the group title           |
| `hidden`   | boolean | Hide the entire group from navigation            |
| `expanded` | boolean | Whether the group starts expanded                |
| `root`     | string  | Page slug to use as the group's clickable header |
| `tag`      | string  | Badge label next to the group title              |

## Anchors

Anchors are persistent external links rendered in the tab bar. They appear alongside tabs and are visible regardless of which tab is active:

```json
{
  "navigation": {
    "tabs": [
      { "tab": "Docs", "groups": [...] }
    ],
    "global": {
      "anchors": [
        { "anchor": "GitHub", "href": "https://github.com/example", "icon": "github" },
        { "anchor": "Discord", "href": "https://discord.gg/example", "icon": "message-circle" }
      ]
    }
  }
}
```

You can also place `anchors` at the top level of the navigation object (equivalent to `global.anchors`).


---

*Powered by [holocron.so](https://holocron.so)*