> For the complete documentation index, see [llms.txt](https://docs.themeupstudio.com/crimson/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.themeupstudio.com/crimson/navigation/primary-navigation.md).

# Primary Navigation

### What is Primary Navigation in Crimson?

**Primary Navigation** is the **main menu bar** in your header — usually the set of links visitors expect everywhere (Home, About, Contact, etc.). Crimson uses Ghost’s built-in **Primary** navigation section for this menu.

<figure><img src="https://464534970-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmXa9lIfIwW6chk5JFHo%2Fuploads%2F354dJF5HzIb42KrxoxtE%2Fimage.png?alt=media&amp;token=5c24852d-fa2b-455e-a7ed-4c5e2721a036" alt=""><figcaption><p>Primary Navigation</p></figcaption></figure>

#### Where to edit it in Ghost Admin

1. Go to **Ghost Admin → Settings → Navigation**
2. Click the **Customize** link which will open a Navigation popup
3. Click **Primary** tab
4. Add, update, delete, or reorder menu items
5. Click **Save** to save the navigation menu

<figure><img src="https://464534970-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmXa9lIfIwW6chk5JFHo%2Fuploads%2F2PJ6Tjt8cXbNob71FG2N%2Fimage.png?alt=media&amp;token=265cbea8-cb05-4c2d-9e72-89e5ce13ece6" alt=""><figcaption><p>Navigation Settings</p></figcaption></figure>

<figure><img src="https://464534970-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmXa9lIfIwW6chk5JFHo%2Fuploads%2FjON8l4EX58sm7cUsXOcP%2Fimage.png?alt=media&amp;token=a544c1dd-1384-4fb5-afb4-999051d9e4e6" alt=""><figcaption><p>Primary Navigation</p></figcaption></figure>

#### How to add a menu item

Each nav item has:

* **Label** (text shown in the menu)
* **URL** (where it links)

**To add a page you created in Ghost**\
Ghost does *not* automatically add new pages to navigation. You need to:

1. Open your published page
2. Copy the URL
3. Paste it into a new navigation item under **Settings → Navigation**

**Tip: Add tag/category links easily**\
Ghost tags automatically have archive URLs like:

* `/tag/news/`
* `/tag/podcast/`

\
You can use these as “Categories” links in your navigation.

***

### Creating dropdown menus

Crimson supports dropdown navigation. The easiest way to build a dropdown is:

1. Add a **parent** item and set its **URL to `#`**
2. Add **child** items whose **labels start with `-`** (dash)

**Example (Primary dropdown)**

* **Custom Pages** → `#`
* **-**&#x41;ccount → `/account/`
* **-**&#x54;ags → `/tags/`
* **-**&#x41;rchive → `/archive/`

<figure><img src="https://464534970-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmXa9lIfIwW6chk5JFHo%2Fuploads%2FperxxttnyifzUBek0ssh%2Fimage.png?alt=media&amp;token=ff4060c0-149d-4588-936f-6f860c422b81" alt=""><figcaption><p>Dropdown Settings in Primary Navigation</p></figcaption></figure>

This will render “Custom Pages” as a dropdown with the child links beneath it.

<figure><img src="https://464534970-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmXa9lIfIwW6chk5JFHo%2Fuploads%2FASHyFT8V2I4tUVOE3ZA4%2Fimage.png?alt=media&amp;token=ea17ee91-5a0b-4279-be81-95231e221806" alt=""><figcaption><p>Dropdown Rendered in Primary Navigation</p></figcaption></figure>

{% hint style="danger" %}

#### Important dropdown warning

In Crimson, **the very last menu item cannot be a dropdown parent that links to `#`**, or the navigation may fail to render.

If your last item must be a dropdown parent, add one normal link after it.

**In Short: There should not be an empty dropdown parent without any dropdown children under it.**
{% endhint %}

#### Primary Navigation best practices

1. Keep it **simple**: aim for **4–6 main links**
2. Use it for “always-needed” pages: Home, About, Services, Contact, Membership
3. Avoid stuffing categories here (put categories into Secondary navigation instead)

#### How it behaves on mobile

On smaller screens, **Primary navigation becomes the hamburger menu**, while Secondary navigation scrolls horizontally.

<figure><img src="https://464534970-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmXa9lIfIwW6chk5JFHo%2Fuploads%2FfH5oWWumoarHAA3YCMt7%2FScreen%20Shot%202026-01-10%20at%2019.42.33.png?alt=media&amp;token=398b95cf-8bec-42a0-835b-25b09b5ca1bb" alt="" width="375"><figcaption><p>Primary Navigation on Mobile device</p></figcaption></figure>

***

### Troubleshooting

<details>

<summary>My dropdown doesn’t appear or appears broken</summary>

* Confirm the parent URL is exactly `#`
* Confirm children labels start with `-`
* Confirm your last nav item is *not* a parent linking to `#`

</details>

<details>

<summary>My menu link goes to a 404</summary>

* Make sure the page is **published** and is accessible using it's direct link
* Make sure the URL includes the correct path

</details>
