Skip to content

# Navigation Settings

Customize the public-facing navigation menu from the admin panel. The navigation bar appears on all public pages, the admin header, the Gancio events page, and the MkDocs documentation site.

## Key Features

- Per-item toggle -- enable or disable each navigation item with a switch
- Custom links -- add external links or internal paths to the navigation
- Reorder -- move items up and down to arrange them in any order
- Editable labels and paths -- rename any item or change its destination
- Feature flag awareness -- builtin items tied to a feature flag (e.g., Campaigns requires `enableInfluence`) are automatically hidden when that feature is disabled
- Visitor control -- determine exactly what public visitors can access

## Builtin Items

The platform ships with 11 builtin navigation items that cover the main public routes:

Home, Campaigns, Map, Shifts, Events, Gallery, Pricing, Shop, Donate, Website (landing page), and Docs (documentation site).

Each builtin item has a default icon and path. Some paths use special `$` tokens (e.g., `$landing`, `$docs`) that are automatically resolved to the correct external URL based on the deployment environment.

## Custom Links

Add any number of custom links via the "Add Custom Link" button. Custom links support:

- Internal paths (e.g., `/blog`)
- External URLs (e.g., `https://example.com`) -- automatically detected and opened in a new tab

Custom links can be deleted from the navigation; builtin items can only be toggled off.

## Mobile Handling

On mobile devices, the navigation collapses into a hamburger menu that opens a full-height drawer. On desktop, the nav bar also supports a collapse mode that hides labels and shows only icons, toggled via a fold/unfold button. The collapse state is persisted in local storage.

## Admin Routes

- `/app/navigation` -- navigation editor with per-item toggle, reorder, label editing, and custom link management