mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
2016c35157
Generated-By: mintlify-agent Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
45 lines
2.5 KiB
Plaintext
45 lines
2.5 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. Changes you make in the editor sync 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 add an element nested inside another, click the <Icon icon="plus" /> plus button next to that element.
|
|
|
|
After creating an element, drag and drop it to reorder or nest it. 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, convert it to a different element type, duplicate it, add a page inside it, add a 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.
|
|
|