> ## Documentation Index
> Fetch the complete documentation index at: https://learn.nexudus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Navigation Editor

> Organise your portal menu with fixed categories, custom groups and drag-and-drop ordering.

The Navigation editor controls how pages appear in the portal's top navigation menu. You can add both built-in and custom pages, group them into categories, and reorder them with drag-and-drop.

Access it from the **Navigation** link at the bottom of the editor's left menu.

## Navigation structure

The portal navigation is made up of two kinds of elements:

1. **Fixed categories** — four locked root-level categories that are always present.
2. **Custom groups** — root-level groups that you create and manage yourself.

### Fixed categories

Every portal ships with four permanent categories:

| Category        | Purpose                                                               |
| --------------- | --------------------------------------------------------------------- |
| **Bookings**    | Resource management — booking pages, resource list, resource calendar |
| **Store**       | Products and checkout pages                                           |
| **Memberships** | Plans and subscriptions                                               |
| **Community**   | Events, perks, community board, directory                             |

Fixed categories are marked with a **\[fixed]** badge and a lock icon. You cannot remove, rename or reorder them, but you **can** add items inside them.

### Custom groups

Custom groups are root-level categories that you create. They work exactly like fixed categories in that they hold navigation items, but you can:

* **Rename** them by editing the group label.
* **Reorder** them relative to other custom groups.
* **Delete** them (and their child items).

<Warning>Groups cannot be nested inside other groups. They must remain at the root level.</Warning>

## Navigation items

Each item in a category or group is one of two types:

| Type         | Description                                                                                                          |
| ------------ | -------------------------------------------------------------------------------------------------------------------- |
| **Built-in** | A reference to a standard portal page (e.g. Resource List, Events, Personal Dashboard). Uses the page's OutlineName. |
| **Custom**   | A reference to a published custom page you created in the editor. Identified by its page ID.                         |

## Editor layout

The Navigation editor is split into two panels:

### Left panel — Page picker

The left panel lets you browse and add pages to the navigation:

* **Built-in pages** tab — lists all available built-in pages alphabetically.
* **Custom pages** tab — lists your published custom pages (each shows a permalink badge).
* **"Add into" dropdown** — choose the target: a fixed category, a custom group, or the root level. Selecting a page adds it to the chosen target.

### Right panel — Navigation tree

The right panel shows the current navigation structure:

* **Fixed categories** — displayed at the top with their child items. The category header shows a lock icon and a \[fixed] badge.
* **Custom groups** — displayed below fixed categories. Each group header has an editable label and a delete button.
* All items within categories and groups are **drag-and-drop reorderable**.

## Drag-and-drop rules

| Action                                          | Allowed? |
| ----------------------------------------------- | -------- |
| Reorder items within the same category/group    | Yes      |
| Move an item from one category/group to another | Yes      |
| Reorder custom groups relative to each other    | Yes      |
| Drag a group into a fixed category              | No       |
| Nest a group inside another group               | No       |
| Remove or reorder fixed categories              | No       |

## Adding pages to the navigation

### Add a built-in page

1. In the left panel, select the **Built-in pages** tab.
2. Use the **"Add into"** dropdown to pick the target category or group.
3. Click on the page you want to add.
4. The page appears as a new item inside the chosen target.

### Add a custom page

1. Switch to the **Custom pages** tab.
2. Use the **"Add into"** dropdown to pick the target.
3. Click a published custom page.
4. It appears inside the chosen target.

<Note>
  Only **published** custom pages appear in the Custom pages tab. If you don't see a page, make sure it has been saved with a Published status in the
  editor.
</Note>

### Create a new custom group

To create a new top-level navigation group:

1. Click **Add group** (at the bottom or in the toolbar area of the right panel).
2. Give it a label.
3. Add pages into it from the left panel.

## Saving

Click **Save** in the toolbar to persist your navigation changes. The updated navigation takes effect across the portal immediately.
