Skip to main content

Menu Fields

Navigation structures that help organize and display links to different pages, products, collections, and other content

Updated this week

General

ID

Description

Example Value

Shopify's unique menu identifier

123456

If present, the ID will be used to group multiple rows together into a single menu. When importing, the ID will be used to see if the menu already exists on the store. If there's no ID match the app will attempt to find an existing menu using the Handle.

Handle

Description

Example Value

URL-friendly identifier

main-menu

The handle is the URL-friendly version of the menu title used in the menu's identifier. The handle is used for grouping multiple rows together into a single menu and finding an existing menu on the store if the ID is not present.

Command

Description

Example Value

Action to perform: MERGE, DELETE, NEW

MERGE

  • MERGE: Update existing menu or create if not found

  • DELETE: Remove the menu from the store

  • NEW: Create a new menu (will fail if menu already exists)

Title

Description

Example Value

Menu name

Main Menu

The display name of the menu that appears in the Shopify admin.

Is Default

Description

Example Value

Whether this is the default menu

TRUE

  • TRUE: This menu is set as the default menu for the theme

  • FALSE: This is a custom menu that can be assigned to specific theme locations

Top Row

Description

Example Value

Whether this is the first row for this menu

TRUE

  • TRUE: This is the primary row for the menu

  • FALSE: This is a secondary row (e.g., for menu items or additional data)

Row

Description

Example Value

Row number for multi-row data

2

Used when a menu spans multiple rows (e.g., when including menu items).

Menu Items

Description

Example Value

Unique identifier for menu item

789012

The unique identifier for a specific menu item within the menu.

Description

Example Value

Text displayed for the menu item

Shop All

The text that customers see for this menu item in the navigation.

Description

Example Value

Action to perform: MERGE, DELETE, NEW

MERGE

  • MERGE: Update existing menu item or create if not found

  • DELETE: Remove the menu item from the menu

  • NEW: Create a new menu item (will fail if item already exists)

Description

Example Value

Type of linked resource

COLLECTION

The type of Shopify resource this menu item links to. Common values include:

  • COLLECTION: Links to a product collection

  • PRODUCT: Links to a specific product

  • PAGE: Links to a static page

  • BLOG: Links to a blog

  • ARTICLE: Links to a specific blog post

  • HTTP: Links to an external URL

Description

Example Value

ID of linked resource

345678

The unique identifier of the Shopify resource this menu item links to (if applicable).

Description

Example Value

Handle of linked resource

all-products

The handle of the Shopify resource this menu item links to (if applicable).

Description

Example Value

Tags for collection filtering

summer, new

Comma-separated tags used to filter collections when the menu item links to a collection.

Description

Example Value

Direct URL for the menu item

/collections/all

Direct URL path or external URL for the menu item. Used when linking to custom URLs or external sites.

Description

Example Value

ID of parent menu item

567890

The unique identifier of the parent menu item, used to create sub-menus or dropdown navigation.

Description

Example Value

Title of parent menu item

Collections

The title of the parent menu item, used for reference when creating hierarchical menus.

Description

Example Value

Display order of the menu item

1

The numerical position determining the order in which menu items appear. Lower numbers appear first.

Did this answer your question?