mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
Ethan Palm
991cf6374c
* Update organize/navigation.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> * Update es/organize/navigation.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> * copyedit * undo Spanish edits * spacing * Update navigation.mdx --------- Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
851 lines
23 KiB
Plaintext
851 lines
23 KiB
Plaintext
---
|
|
title: "Navigation"
|
|
description: "Design information architecture that aligns with user needs."
|
|
keywords: ["navigation structure", "sidebar configuration", "page organization", "navigation groups"]
|
|
---
|
|
|
|
The [navigation](/organize/settings#param-navigation) property in `docs.json` controls the structure and information hierarchy of your documentation.
|
|
|
|
With proper navigation configuration, you can organize your content so that users can find exactly what they're looking for.
|
|
|
|
Choose one primary organizational pattern at the root level of your navigation. Once you've chosen your primary pattern, you can nest other navigation elements within it.
|
|
|
|
## Pages
|
|
|
|
Pages are the most fundamental navigation component. Each page is an MDX file in your documentation repository.
|
|
|
|
<img
|
|
className="block dark:hidden pointer-events-none"
|
|
src="/images/navigation/pages-light.png"
|
|
alt="Decorative graphic of pages."
|
|
/>
|
|
|
|
<img
|
|
className="hidden dark:block pointer-events-none"
|
|
src="/images/navigation/pages-dark.png"
|
|
alt="Decorative graphic of pages."
|
|
/>
|
|
|
|
In the `navigation` object, `pages` is an array where each entry must reference the path to a [page file](/organize/pages).
|
|
|
|
```json
|
|
{
|
|
"navigation": {
|
|
"pages": [
|
|
"settings",
|
|
"pages",
|
|
"navigation",
|
|
"themes",
|
|
"custom-domain"
|
|
]
|
|
}
|
|
}
|
|
```
|
|
|
|
## Groups
|
|
|
|
Use groups to organize your sidebar navigation into sections. Groups can be nested within each other, labeled with tags, and styled with icons.
|
|
|
|
<img
|
|
className="block dark:hidden pointer-events-none"
|
|
src="/images/navigation/groups-light.png"
|
|
alt="Decorative graphic of groups."
|
|
/>
|
|
|
|
<img
|
|
className="hidden dark:block pointer-events-none"
|
|
src="/images/navigation/groups-dark.png"
|
|
alt="Decorative graphic of groups."
|
|
/>
|
|
|
|
In the `navigation` object, `groups` is an array where each entry is an object that requires a `group` field and a `pages` field. The `icon`, `tag`, and `expanded` fields are optional.
|
|
|
|
```json
|
|
{
|
|
"navigation": {
|
|
"groups": [
|
|
{
|
|
"group": "Getting started",
|
|
"icon": "play",
|
|
"pages": [
|
|
"quickstart",
|
|
{
|
|
"group": "Editing",
|
|
"expanded": false,
|
|
"icon": "pencil",
|
|
"pages": [
|
|
"installation",
|
|
"editor"
|
|
]
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"group": "Writing content",
|
|
"icon": "notebook-text",
|
|
"tag": "NEW",
|
|
"pages": [
|
|
"writing-content/page",
|
|
"writing-content/text"
|
|
]
|
|
}
|
|
]
|
|
}
|
|
}
|
|
```
|
|
|
|
### Default expanded state
|
|
|
|
Use the `expanded` property to control the default state of a nested group in the navigation sidebar.
|
|
|
|
- `expanded: true`: Group is expanded by default.
|
|
- `expanded: false` or omitted: Group is collapsed by default.
|
|
|
|
<Note>
|
|
The `expanded` property only affects nested groups--groups within groups. Top-level groups are always expanded and cannot be collapsed.
|
|
</Note>
|
|
|
|
```json
|
|
{
|
|
"group": "Getting started",
|
|
"pages": [
|
|
"quickstart",
|
|
{
|
|
"group": "Advanced",
|
|
"expanded": false,
|
|
"pages": ["installation", "configuration"]
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
## Tabs
|
|
|
|
Tabs create distinct sections of your documentation with separate URL paths. Tabs create a horizontal navigation bar at the top of your documentation that lets users switch between sections.
|
|
|
|
<img
|
|
className="block dark:hidden pointer-events-none"
|
|
src="/images/navigation/tabs-light.png"
|
|
alt="Decorative graphic of a tab navigation."
|
|
/>
|
|
|
|
<img
|
|
className="hidden dark:block pointer-events-none"
|
|
src="/images/navigation/tabs-dark.png"
|
|
alt="Decorative graphic of a tab navigation."
|
|
/>
|
|
|
|
In the `navigation` object, `tabs` is an array where each entry is an object that requires a `tab` field and can contain other navigation fields such as groups, pages, icons, or links to external pages.
|
|
|
|
```json
|
|
{
|
|
"navigation": {
|
|
"tabs": [
|
|
{
|
|
"tab": "API reference",
|
|
"icon": "square-terminal",
|
|
"pages": [
|
|
"api-reference/get",
|
|
"api-reference/post",
|
|
"api-reference/delete"
|
|
]
|
|
},
|
|
{
|
|
"tab": "SDKs",
|
|
"icon": "code",
|
|
"pages": [
|
|
"sdk/fetch",
|
|
"sdk/create",
|
|
"sdk/delete"
|
|
]
|
|
},
|
|
{
|
|
"tab": "Blog",
|
|
"icon": "newspaper",
|
|
"href": "https://external-link.com/blog"
|
|
}
|
|
]
|
|
}
|
|
}
|
|
```
|
|
|
|
### Menus
|
|
|
|
Menus add dropdown navigation items to a tab. Use menus to help users go directly to specific pages within a tab.
|
|
|
|
In the `navigation` object, `menu` is an array where each entry is an object that requires an `item` field and can contain other navigation fields such as groups, pages, icons, or links to external pages.
|
|
|
|
Menu items can only contain groups, pages, and external links.
|
|
|
|
```json
|
|
{
|
|
"navigation": {
|
|
"tabs": [
|
|
{
|
|
"tab": "Developer tools",
|
|
"icon": "square-terminal",
|
|
"menu": [
|
|
{
|
|
"item": "API reference",
|
|
"icon": "rocket",
|
|
"groups": [
|
|
{
|
|
"group": "Core endpoints",
|
|
"icon": "square-terminal",
|
|
"pages": [
|
|
"api-reference/get",
|
|
"api-reference/post",
|
|
"api-reference/delete"
|
|
]
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"item": "SDKs",
|
|
"icon": "code",
|
|
"description": "SDKs are used to interact with the API.",
|
|
"pages": [
|
|
"sdk/fetch",
|
|
"sdk/create",
|
|
"sdk/delete"
|
|
]
|
|
}
|
|
]
|
|
}
|
|
]
|
|
}
|
|
}
|
|
```
|
|
|
|
## Anchors
|
|
|
|
Anchors add persistent navigation items to the top of your sidebar. Use anchors to section your content, provide quick access to external resources, or create prominent calls to action.
|
|
|
|
<img
|
|
className="block dark:hidden pointer-events-none"
|
|
src="/images/navigation/anchors-light.png"
|
|
alt="Decorative graphic of an anchor navigation."
|
|
/>
|
|
|
|
<img
|
|
className="hidden dark:block pointer-events-none"
|
|
src="/images/navigation/anchors-dark.png"
|
|
alt="Decorative graphic of an anchor navigation."
|
|
/>
|
|
|
|
In the `navigation` object, `anchors` is an array where each entry is an object that requires an `anchor` field and can contain other navigation fields such as groups, pages, icons, or links to external pages.
|
|
|
|
```json
|
|
{
|
|
"navigation": {
|
|
"anchors": [
|
|
{
|
|
"anchor": "Documentation",
|
|
"icon": "book-open",
|
|
"pages": [
|
|
"quickstart",
|
|
"development",
|
|
"navigation"
|
|
]
|
|
},
|
|
{
|
|
"anchor": "API reference",
|
|
"icon": "square-terminal",
|
|
"pages": [
|
|
"api-reference/get",
|
|
"api-reference/post",
|
|
"api-reference/delete"
|
|
]
|
|
},
|
|
{
|
|
"anchor": "Blog",
|
|
"href": "https://external-link.com/blog"
|
|
}
|
|
]
|
|
}
|
|
}
|
|
```
|
|
|
|
### Global anchors
|
|
|
|
Use global anchors for links that should appear on all pages, regardless of which section of your navigation the user is viewing. Global anchors are particularly useful for linking to resources outside your documentation (such as a blog, community forum, or support portal) or for providing consistent access to important internal pages (such as a changelog or status page).
|
|
|
|
Global anchors support both external URLs and relative paths to pages within your documentation.
|
|
|
|
```json
|
|
{
|
|
"navigation": {
|
|
"global": {
|
|
"anchors": [
|
|
{
|
|
"anchor": "Changelog",
|
|
"icon": "list",
|
|
"href": "/changelog"
|
|
},
|
|
{
|
|
"anchor": "Blog",
|
|
"icon": "pencil",
|
|
"href": "https://mintlify.com/blog"
|
|
}
|
|
]
|
|
},
|
|
"tabs": /*...*/
|
|
}
|
|
}
|
|
```
|
|
|
|
## Dropdowns
|
|
|
|
Dropdowns are contained in an expandable menu at the top of your sidebar navigation. Each item in a dropdown directs to a section of your documentation.
|
|
|
|
<img
|
|
className="block dark:hidden pointer-events-none"
|
|
src="/images/navigation/dropdowns-light.png"
|
|
alt="Decorative graphic of a dropdown navigation."
|
|
/>
|
|
|
|
<img
|
|
className="hidden dark:block pointer-events-none"
|
|
src="/images/navigation/dropdowns-dark.png"
|
|
alt="Decorative graphic of a dropdown navigation."
|
|
/>
|
|
|
|
In the `navigation` object, `dropdowns` is an array where each entry is an object that requires a `dropdown` field and can contain other navigation fields such as groups, pages, icons, or links to external pages.
|
|
|
|
```json
|
|
{
|
|
"navigation": {
|
|
"dropdowns": [
|
|
{
|
|
"dropdown": "Documentation",
|
|
"icon": "book-open",
|
|
"pages": [
|
|
"quickstart",
|
|
"development",
|
|
"navigation"
|
|
]
|
|
},
|
|
{
|
|
"dropdown": "API reference",
|
|
"icon": "square-terminal",
|
|
"pages": [
|
|
"api-reference/get",
|
|
"api-reference/post",
|
|
"api-reference/delete"
|
|
]
|
|
},
|
|
{
|
|
"dropdown": "Blog",
|
|
"href": "https://external-link.com/blog"
|
|
}
|
|
]
|
|
}
|
|
}
|
|
```
|
|
|
|
## Products
|
|
|
|
<img
|
|
className="block dark:hidden pointer-events-none"
|
|
src="/images/navigation/product-switcher-light.png"
|
|
alt="Decorative graphic of a product switcher."
|
|
/>
|
|
|
|
<img
|
|
className="hidden dark:block pointer-events-none"
|
|
src="/images/navigation/product-switcher-dark.png"
|
|
alt="Decorative graphic of a product switcher."
|
|
/>
|
|
|
|
Products create a dedicated navigation division for organizing product-specific documentation. Use products to separate different offerings, services, or major feature sets within your documentation.
|
|
|
|
In the `navigation` object, `products` is an array where each entry is an object that requires a `product` field and can contain other navigation fields such as groups, pages, icons, or links to external pages.
|
|
|
|
```json
|
|
{
|
|
"navigation": {
|
|
"products": [
|
|
{
|
|
"product": "Core API",
|
|
"description": "Core API description",
|
|
"icon": "api",
|
|
"groups": [
|
|
{
|
|
"group": "Getting started",
|
|
"pages": [
|
|
"core-api/quickstart",
|
|
"core-api/authentication"
|
|
]
|
|
},
|
|
{
|
|
"group": "Endpoints",
|
|
"pages": [
|
|
"core-api/users",
|
|
"core-api/orders"
|
|
]
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"product": "Analytics Platform",
|
|
"description": "Analytics Platform description",
|
|
"icon": "chart-bar",
|
|
"pages": [
|
|
"analytics/overview",
|
|
"analytics/dashboard",
|
|
"analytics/reports"
|
|
]
|
|
},
|
|
{
|
|
"product": "Mobile SDK",
|
|
"description": "Mobile SDK description",
|
|
"icon": "smartphone",
|
|
"href": "https://mobile-sdk-docs.example.com"
|
|
}
|
|
]
|
|
}
|
|
}
|
|
```
|
|
|
|
## OpenAPI
|
|
|
|
Integrate OpenAPI specifications directly into your navigation structure to automatically generate API documentation. Create dedicated API sections or place endpoint pages within other navigation components.
|
|
|
|
Set a default OpenAPI specification at any level of your navigation hierarchy. Child elements will inherit this specification unless they define their own specification.
|
|
|
|
<Note>
|
|
When you add the `openapi` property to a navigation element (such as an anchor, tab, or group) without specifying any pages, Mintlify automatically generates pages for **all endpoints** defined in your OpenAPI specification.
|
|
|
|
To control which endpoints appear, explicitly list the desired endpoints in a `pages` array.
|
|
</Note>
|
|
|
|
For more information about referencing OpenAPI endpoints in your docs, see the [OpenAPI setup](/api-playground/openapi-setup).
|
|
|
|
```json
|
|
{
|
|
"navigation": {
|
|
"groups": [
|
|
{
|
|
"group": "API reference",
|
|
"openapi": "/path/to/openapi-v1.json",
|
|
"pages": [
|
|
"overview",
|
|
"authentication",
|
|
"GET /users",
|
|
"POST /users",
|
|
{
|
|
"group": "Products",
|
|
"openapi": "/path/to/openapi-v2.json",
|
|
"pages": [
|
|
"GET /products",
|
|
"POST /products"
|
|
]
|
|
}
|
|
]
|
|
}
|
|
]
|
|
}
|
|
}
|
|
```
|
|
|
|
## Versions
|
|
|
|
Partition your navigation into different versions. Versions are selectable from a dropdown menu.
|
|
|
|
<img
|
|
className="block dark:hidden pointer-events-none"
|
|
src="/images/navigation/versions-light.png"
|
|
alt="Decorative graphic of a version switcher."
|
|
/>
|
|
|
|
<img
|
|
className="hidden dark:block pointer-events-none"
|
|
src="/images/navigation/versions-dark.png"
|
|
alt="Decorative graphic of a version switcher."
|
|
/>
|
|
|
|
In the `navigation` object, `versions` is an array where each entry is an object that requires a `version` field and can contain any other navigation fields.
|
|
|
|
```json
|
|
{
|
|
"navigation": {
|
|
"versions": [
|
|
{
|
|
"version": "1.0.0",
|
|
"groups": [
|
|
{
|
|
"group": "Getting started",
|
|
"pages": ["v1/overview", "v1/quickstart", "v1/development"]
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"version": "2.0.0",
|
|
"groups": [
|
|
{
|
|
"group": "Getting started",
|
|
"pages": ["v2/overview", "v2/quickstart", "v2/development"]
|
|
}
|
|
]
|
|
}
|
|
]
|
|
}
|
|
}
|
|
```
|
|
|
|
## Languages
|
|
|
|
Partition your navigation into different languages. Languages are selectable from a dropdown menu.
|
|
|
|
<img
|
|
className="block dark:hidden pointer-events-none"
|
|
src="/images/navigation/languages-light.png"
|
|
alt="Decorative graphic of a language switcher."
|
|
/>
|
|
|
|
<img
|
|
className="hidden dark:block pointer-events-none"
|
|
src="/images/navigation/languages-dark.png"
|
|
alt="Decorative graphic of a language switcher."
|
|
/>
|
|
|
|
In the `navigation` object, `languages` is an array where each entry is an object that requires a `language` field and can contain any other navigation fields, including language-specific banner configurations.
|
|
|
|
We currently support the following languages for localization:
|
|
|
|
<CardGroup cols={2}>
|
|
<Card title="Arabic (ar)" icon="/images/navigation/languages/ar.png" horizontal />
|
|
<Card title="Czech (cs)" icon="/images/navigation/languages/cs.png" horizontal />
|
|
<Card title="Chinese (cn)" icon="/images/navigation/languages/cn.png" horizontal />
|
|
<Card title="Chinese (zh-Hant)" icon="/images/navigation/languages/cn.png" horizontal />
|
|
<Card title="Dutch (nl)" icon="/images/navigation/languages/nl.png" horizontal />
|
|
<Card title="English (en)" icon="/images/navigation/languages/en.png" horizontal />
|
|
<Card title="French (fr)" icon="/images/navigation/languages/fr.png" horizontal />
|
|
<Card title="German (de)" icon="/images/navigation/languages/de.png" horizontal />
|
|
<Card title="Hebrew (he)" icon="/images/navigation/languages/he.png" horizontal />
|
|
<Card title="Hindi (hi)" icon="/images/navigation/languages/hi.png" horizontal />
|
|
<Card title="Indonesian (id)" icon="/images/navigation/languages/id.png" horizontal />
|
|
<Card title="Italian (it)" icon="/images/navigation/languages/it.png" horizontal />
|
|
<Card title="Japanese (jp)" icon="/images/navigation/languages/jp.png" horizontal />
|
|
<Card title="Korean (ko)" icon="/images/navigation/languages/ko.png" horizontal />
|
|
<Card title="Latvian (lv)" icon="/images/navigation/languages/lv.png" horizontal />
|
|
<Card title="Norwegian (no)" icon="/images/navigation/languages/no.png" horizontal />
|
|
<Card title="Polish (pl)" icon="/images/navigation/languages/pl.png" horizontal />
|
|
<Card title="Portuguese (pt-BR)" icon="/images/navigation/languages/pt-br.png" horizontal />
|
|
<Card title="Romanian (ro)" icon="/images/navigation/languages/ro.png" horizontal />
|
|
<Card title="Russian (ru)" icon="/images/navigation/languages/ru.png" horizontal />
|
|
<Card title="Spanish (es)" icon="/images/navigation/languages/es.png" horizontal />
|
|
<Card title="Swedish (sv)" icon="/images/navigation/languages/sv.png" horizontal />
|
|
<Card title="Turkish (tr)" icon="/images/navigation/languages/tr.png" horizontal />
|
|
<Card title="Ukrainian (ua)" icon="/images/navigation/languages/ua.png" horizontal />
|
|
<Card title="Uzbek (uz)" icon="/images/navigation/languages/uz.png" horizontal />
|
|
<Card title="Vietnamese (vi)" icon="/images/navigation/languages/vi.png" horizontal />
|
|
</CardGroup>
|
|
|
|
```json
|
|
{
|
|
"navigation": {
|
|
"languages": [
|
|
{
|
|
"language": "en",
|
|
"banner": {
|
|
"content": "🚀 Version 2.0 is now live! See our [changelog](/en/changelog) for details.",
|
|
"dismissible": true
|
|
},
|
|
"groups": [
|
|
{
|
|
"group": "Getting started",
|
|
"pages": ["en/overview", "en/quickstart", "en/development"]
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"language": "es",
|
|
"banner": {
|
|
"content": "🚀 ¡La versión 2.0 ya está disponible! Consulta nuestro [registro de cambios](/es/changelog).",
|
|
"dismissible": true
|
|
},
|
|
"groups": [
|
|
{
|
|
"group": "Getting started",
|
|
"pages": ["es/overview", "es/quickstart", "es/development"]
|
|
}
|
|
]
|
|
}
|
|
]
|
|
}
|
|
}
|
|
```
|
|
|
|
For automated translations, [contact our sales team](mailto:gtm@mintlify.com) to discuss solutions.
|
|
|
|
## Nesting
|
|
|
|
Navigation elements can be nested within each other to create complex hierarchies. You must have one root-level parent navigation element such as tabs, groups, or a dropdown. You can nest other types of navigation elements within your primary navigation pattern.
|
|
|
|
Each navigation element can contain one type of child element at each level of your navigation hierarchy. For example, a tab can contain anchors that contain groups, but a tab cannot contain both anchors and groups at the same level.
|
|
|
|
<CodeGroup>
|
|
|
|
```json Tabs containing anchors
|
|
{
|
|
"navigation": {
|
|
"tabs": [
|
|
{
|
|
"tab": "Documentation",
|
|
"anchors": [
|
|
{
|
|
"anchor": "Guides",
|
|
"icon": "book-open",
|
|
"pages": ["quickstart", "tutorial"]
|
|
},
|
|
{
|
|
"anchor": "API Reference",
|
|
"icon": "code",
|
|
"pages": ["api/overview", "api/endpoints"]
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"tab": "Resources",
|
|
"groups": [
|
|
{
|
|
"group": "Help",
|
|
"pages": ["support", "faq"]
|
|
}
|
|
]
|
|
}
|
|
]
|
|
}
|
|
}
|
|
```
|
|
|
|
```json Anchors containing tabs
|
|
{
|
|
"navigation": {
|
|
"anchors": [
|
|
{
|
|
"anchor": "Documentation",
|
|
"icon": "book-open",
|
|
"tabs": [
|
|
{
|
|
"tab": "Guides",
|
|
"pages": ["quickstart", "tutorial"]
|
|
},
|
|
{
|
|
"tab": "API",
|
|
"pages": ["api/overview", "api/endpoints"]
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"anchor": "Community",
|
|
"icon": "users",
|
|
"href": "https://community.example.com"
|
|
}
|
|
]
|
|
}
|
|
}
|
|
```
|
|
|
|
```json Products containing tabs
|
|
{
|
|
"navigation": {
|
|
"products": [
|
|
{
|
|
"product": "Platform",
|
|
"icon": "server",
|
|
"tabs": [
|
|
{
|
|
"tab": "Documentation",
|
|
"groups": [
|
|
{
|
|
"group": "Getting started",
|
|
"pages": ["platform/quickstart"]
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"tab": "API Reference",
|
|
"pages": ["platform/api"]
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"product": "Mobile SDK",
|
|
"icon": "mobile",
|
|
"pages": ["mobile/overview"]
|
|
}
|
|
]
|
|
}
|
|
}
|
|
```
|
|
|
|
```json Multi-product SaaS with tabs and menu
|
|
{
|
|
"navigation": {
|
|
"products": [
|
|
{
|
|
"product": "Platform",
|
|
"icon": "cloud",
|
|
"tabs": [
|
|
{
|
|
"tab": "Documentation",
|
|
"menu": [
|
|
{
|
|
"item": "Getting Started",
|
|
"icon": "rocket",
|
|
"groups": [
|
|
{
|
|
"group": "Setup",
|
|
"pages": ["platform/install", "platform/config"]
|
|
},
|
|
{
|
|
"group": "Core Concepts",
|
|
"pages": ["platform/concepts/auth", "platform/concepts/data"]
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"item": "Guides",
|
|
"icon": "book",
|
|
"pages": ["platform/guides/deployment", "platform/guides/scaling"]
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"tab": "API Reference",
|
|
"groups": [
|
|
{
|
|
"group": "REST API",
|
|
"pages": ["platform/api/users", "platform/api/projects"]
|
|
},
|
|
{
|
|
"group": "GraphQL",
|
|
"pages": ["platform/api/graphql/queries", "platform/api/graphql/mutations"]
|
|
}
|
|
]
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"product": "Analytics",
|
|
"icon": "chart-bar",
|
|
"tabs": [
|
|
{
|
|
"tab": "Documentation",
|
|
"groups": [
|
|
{
|
|
"group": "Getting Started",
|
|
"pages": ["analytics/quickstart", "analytics/setup"]
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"tab": "API",
|
|
"pages": ["analytics/api/events", "analytics/api/reports"]
|
|
}
|
|
]
|
|
}
|
|
]
|
|
}
|
|
}
|
|
```
|
|
|
|
```json Versioned docs with tabs
|
|
{
|
|
"navigation": {
|
|
"versions": [
|
|
{
|
|
"version": "v2.0",
|
|
"tabs": [
|
|
{
|
|
"tab": "Documentation",
|
|
"groups": [
|
|
{
|
|
"group": "Getting Started",
|
|
"pages": ["v2/quickstart", "v2/migration-from-v1"]
|
|
},
|
|
{
|
|
"group": "Features",
|
|
"pages": ["v2/features/auth", "v2/features/api"]
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"tab": "API Reference",
|
|
"pages": ["v2/api/overview", "v2/api/endpoints"]
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"version": "v1.0",
|
|
"tabs": [
|
|
{
|
|
"tab": "Documentation",
|
|
"groups": [
|
|
{
|
|
"group": "Getting Started",
|
|
"pages": ["v1/quickstart"]
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"tab": "API Reference",
|
|
"pages": ["v1/api/overview"]
|
|
}
|
|
]
|
|
}
|
|
]
|
|
}
|
|
}
|
|
```
|
|
|
|
</CodeGroup>
|
|
|
|
## Breadcrumbs
|
|
|
|
Breadcrumbs display the full navigation path at the top of pages. Some themes have breadcrumbs enabled by default and others do not. You can control whether breadcrumbs are enabled for your site using the `styling` property in your `docs.json`.
|
|
|
|
<CodeGroup>
|
|
|
|
```json Display full breadcrumbs
|
|
"styling": {
|
|
"eyebrows": "breadcrumbs"
|
|
}
|
|
```
|
|
|
|
```json Display parent section only
|
|
"styling": {
|
|
"eyebrows": "section"
|
|
}
|
|
```
|
|
|
|
</CodeGroup>
|
|
|
|
## Interaction configuration
|
|
|
|
Control how users interact with navigation elements using the `interaction` property in your `docs.json`.
|
|
|
|
### Enable auto-navigation for groups
|
|
|
|
When a user expands a navigation group, some themes will automatically navigate to the first page in the group. You can override a theme's default behavior using the `drilldown` option.
|
|
|
|
- Set to `true` to force automatic navigation to the first page when a navigation group is selected.
|
|
- Set to `false` to prevent navigation and only expand or collapse the group when it is selected.
|
|
- Leave unset to use the theme's default behavior.
|
|
|
|
<CodeGroup>
|
|
```json Force navigation
|
|
"interaction": {
|
|
"drilldown": true // Force navigation to first page when a user expands a dropdown
|
|
}
|
|
```
|
|
|
|
```json Prevent navigation
|
|
"interaction": {
|
|
"drilldown": false // Never navigate, only expand or collapse the group
|
|
}
|
|
```
|
|
</CodeGroup>
|