mintlify__docs/editor/navigation.mdx

---
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.

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, 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.