Set primary & secondary navigation

Populate the header and secondary menus using Ghost’s primary and secondary navigation settings.

1 min read Swarnil Singhai Updated 3 Feb 2026

Set primary & secondary navigation

The links in the site header and its secondary menu come from Ghost's built-in navigation settings, so you manage them in Ghost Admin without touching the theme. The theme reads Ghost's navigation (primary) and secondary_navigation lists and renders them into the header and, where present, a secondary bar.

Open Settings → Navigation. The Primary navigation list drives the main header menu — this is where you put the site's top-level sections. For this theme the natural primary items map to the collections defined in routes.yaml:

Primary navigation:
  Home        /
  Courses     /courses/
  Training    /training/
  Docs        /docs/
  Blog        /blog/

Secondary navigation:
  About       /about/
  Contact     /contact/
  GitHub      https://github.com/...

Each navigation item is just a label and a URL. Use root-relative URLs (/courses/) for internal pages so links stay correct across environments, and full URLs for external destinations. Drag to reorder; the order in the list is the order in the menu.

The Secondary navigation list is for lower-priority links — About, Contact, social or repository links — which the theme places in a secondary position (for example a top utility bar or the footer area, depending on the layout). Keeping the primary menu short and putting everything else in secondary keeps the header clean and scannable, which matters on mobile where space is tight.

A few tips: match your primary labels to the section names used elsewhere on the site for consistency, avoid deep menus (this theme favours a flat top-level structure), and remember that pages you want in the menu must exist and be published first. Changes to navigation apply immediately on save. The next doc covers how the navbar itself behaves — sticky versus island — via theme settings.