mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
e2787cfd93
* docs: standardize documentation writing style * docs: apply brand tone and style fixes * docs: refine brand tone and writing style * Revert changelog.mdx changes The changelog is generated content and shouldn't be rewritten by the brand tone and writing style pass. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> * Update ai/model-context-protocol.mdx * Update ai/model-context-protocol.mdx --------- Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
45 lines
2.4 KiB
Plaintext
45 lines
2.4 KiB
Plaintext
---
|
|
title: "Organize navigation"
|
|
description: "Reorder pages, add groups, and manage your documentation sidebar structure using drag-and-drop in the Mintlify web editor—no docs.json edits needed."
|
|
keywords: ["editor", "navigation", "sidebar", "structure"]
|
|
---
|
|
|
|
Use the navigation sidebar to organize your documentation. The editor syncs your changes to your repository when you publish. You don't need to edit `docs.json` manually.
|
|
|
|
## Add navigation elements
|
|
|
|
Click **Add new** at the bottom of the navigation tree to add a new element at the root level. To nest an element inside another, click the <Icon icon="plus" /> plus button next to that element.
|
|
|
|
Drag and drop elements to reorder or nest them. Hover over an element and click the gear icon to configure its properties.
|
|
|
|
Right-click a **page** to open its settings or delete it.
|
|
|
|
Right-click a **navigation element** to open its settings or convert it to a different element type. You can also duplicate it, add a page or group inside it, ungroup it, or delete it.
|
|
|
|
<Note>
|
|
Some elements cannot nest inside other elements. For example, tabs cannot nest inside groups. The editor prevents you from creating invalid combinations.
|
|
</Note>
|
|
|
|
## Navigation elements
|
|
|
|
Choose the right structure for your content:
|
|
|
|
- **Pages**—Individual documentation files. The core building block of navigation.
|
|
- **Groups**—Collapsible sections that cluster related pages together. Can nest within other groups.
|
|
- **Tabs**—Top-level sections with horizontal navigation at the top of your site. Use tabs when you have distinct areas like API Reference and Guides.
|
|
- **Anchors**—Persistent items at the top of your sidebar. Useful for quick access to external resources or top-level sections. Can be global to appear on every page.
|
|
- **Dropdowns**—Expandable menus at the top of your sidebar. A lighter alternative to tabs for multiple related sections.
|
|
- **Menus**—Dropdown navigation items within a tab for direct links to specific pages.
|
|
- **Products**—A switcher for multiple distinct product documentation sets, each with its own navigation structure.
|
|
- **Versions**—A switcher for multiple simultaneous documentation versions.
|
|
- **Languages**—A switcher for documentation in multiple languages.
|
|
|
|
## Configure elements
|
|
|
|
Hover over any navigation element and click the gear icon to set:
|
|
|
|
- **Title**: The label shown in the sidebar.
|
|
- **Icon**: A visual marker next to the label.
|
|
- **Tag**: A badge like "NEW" or "BETA" to highlight the item.
|
|
|