General
ID
Description | Example Value |
Shopify's unique menu identifier |
|
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 |
|
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, REPLACE, UPDATE |
|
MERGE: Update existing menu or create if not found
DELETE: Remove the menu from the store (will skip if menu doesn't exist)
NEW: Create a new menu (will skip if menu already exists)
REPLACE: Delete existing menu and recreate it from scratch
UPDATE: Update existing menu only (will skip if menu doesn't exist)
Title
Description | Example Value |
Menu name |
|
The display name of the menu that appears in the Shopify admin.
Is Default
Description | Example Value |
Whether this is the default menu |
|
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: 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 |
|
Used when a menu spans multiple rows (e.g., when including menu items).
Menu Items
Menu Item: ID
Description | Example Value |
Unique identifier for menu item |
|
The unique identifier for a specific menu item within the menu.
Menu Item: Title
Description | Example Value |
Text displayed for the menu item |
|
The text that customers see for this menu item in the navigation.
Menu Item: Command
Description | Example Value |
Action to perform: MERGE, DELETE, NEW |
|
Controls what happens to each individual menu item when updating an existing menu. Items not included in the spreadsheet are preserved - only the rows you include are affected.
MERGE (default): Match by Menu Item: ID first, then by Menu Item: Title. If a match is found, update the existing item's fields. If no match is found, add as a new item.
DELETE: Match by ID or title and remove the item from the menu. If no match is found, the item is skipped with a warning.
NEW: Only add the item if no match is found. If a matching item already exists, it is skipped.
To replace all menu items at once (removing items not in the spreadsheet), use the menu-level REPLACE command instead.
Menu Item: Resource Type
Description | Example Value |
Type of linked resource |
|
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
Menu Item: Resource ID
Description | Example Value |
ID of linked resource |
|
The unique identifier of the Shopify resource this menu item links to (if applicable).
Menu Item: Resource Handle
Description | Example Value |
Handle of linked resource |
|
The handle of the Shopify resource this menu item links to (if applicable).
Menu Item: Collection Tags
Description | Example Value |
Tags for collection filtering |
|
Comma-separated tags used to filter collections when the menu item links to a collection.
Menu Item: URL
Description | Example Value |
Direct URL for the menu item |
|
Direct URL path or external URL for the menu item. Used when linking to custom URLs or external sites.
Menu Item: Parent ID
Description | Example Value |
ID of parent menu item |
|
The unique identifier of the parent menu item, used to create sub-menus or dropdown navigation.
Menu Item: Parent Title
Description | Example Value |
Title of parent menu item |
|
The title of the parent menu item, used for reference when creating hierarchical menus.
Menu Item: Position
Description | Example Value |
Display order of the menu item |
|
The numerical position (1-based) determining the order in which menu items appear. Lower numbers appear first. When adding new items to an existing menu via selective merge, the position controls where the item is inserted among the existing items.