Navigation menus control how visitors move through your storefront. You can create multiple menus — one for your header, one or more for your footer columns, and any others your theme references — and populate them with links to any part of your store. The Navigation Editor in your admin dashboard is the central place to build and update all menus.Documentation Index
Fetch the complete documentation index at: https://docs.cartble.com/llms.txt
Use this file to discover all available pages before exploring further.
Opening the Navigation Editor
In your admin sidebar, click Navigation. The Navigation Editor opens with a list of all existing menus on the left and an item editor on the right.Navigation menus
Each menu has three fields:| Field | Description |
|---|---|
| Name | A human-readable label used inside the admin (e.g., “Main Menu”, “Footer Links”) |
| Handle | A unique lowercase slug used to reference the menu in theme settings (e.g., main-menu, footer-links) |
| Items | An ordered list of navigation items |
Navigation item types
Each item in a menu has a type that determines what it links to:home
Links directly to your storefront homepage. No additional target required.
collection
Links to a specific product collection. Set
targetId to the collection’s ID.category
Links to a product category page. Set
targetId to the category’s ID.page
Links to a CMS page (a page you created in the Pages manager). Set
targetId to the page’s ID.custom
Links to any URL you enter manually. Set the
url field to the full destination path or external URL.Nested items (multi-level dropdowns)
Any navigation item can have children — a nested list of items that appear as a dropdown or sub-menu when the parent is hovered or clicked. Children support the same five item types as top-level items, and each child can itself carry further nested children for deep multi-level navigation.Design options for dropdown items
Items that have children also expose a design configuration block that controls how the dropdown renders:| Option | Type | Description |
|---|---|---|
| Display type | dropdown or mega-menu | Controls whether children appear as a standard vertical dropdown or an expanded mega-menu panel |
| Columns | Number | For mega-menus, sets how many columns the child items are distributed across |
| Background image | Image URL | Optional background image shown inside the mega-menu panel |
| Featured | Boolean | Marks this item as featured, which themes may use to apply a visual highlight |
The mega-menu display type requires your theme’s Header menu type setting to be set to
mega in the theme editor. If the header is in simple mode, all items render as standard dropdowns regardless of the per-item design setting.Adding, reordering, and removing items
Select or create a menu
In the Navigation Editor, click an existing menu to open it, or click New menu to create one. Give it a name and a unique handle.
Add an item
Click Add item inside the menu. Choose the item type, enter a label, and — for collection, category, and page types — select the target from the picker. For custom items, enter the destination URL.
Nest items
Drag an item beneath another item and indent it to make it a child. Alternatively, use the Add child action on any existing item to append a nested entry directly.
Configure design options
Click the settings icon on any item that has children to set the display type, column count, background image, and featured flag.
Reorder items
Drag items up or down the list to change their order. Drag nested items within their parent group to reorder them independently.
Remove an item
Click the delete icon on any item to remove it. Removing a parent item also removes all of its children.