Tabs

Top-level tabbed navigation for docs sites.

Top-level tabs are the section bar in the docs header. Each sections: entry in site.yaml is one tab with its own sidebar navigation tree.

sections:
  - name: Guides
    slug: guides
    path: guides
    icon: book-open
  - name: API
    slug: api
    api: payments
    icon: code
  - name: Reference
    icon: box
    children:
      - name: SDK
        slug: sdk
        sdk: payments-sdk
        icon: terminal

Field	Notes
`name`	Tab label
`slug`	URL segment for leaf sections
`icon`	Optional emoji, short text, or Lucide name (`book`, `book-open`, `box`, `code`, `file`, `file-text`, `globe`, `key`, `settings`, `shield`, `terminal`, `users`)
`children`	Group tab with a dropdown of child sections

Guide sections use Markdown under path. Embed sections use api, sdk, or cli. See Navigation and site.yaml.