Store menus

Define storefront menus, order their items, enter localized names and template values, and publish the menu with a template.

The Store menus screen is where storefront navigation menus (such as main menu, footer menu, app menu) are defined and published. A menu consists of three parts: the menu record itself, the ordered items in the menu (category, product, content, or address links), and the Menu template used to render the menu on the storefront. The Publish button processes the menu through the selected template and produces the published output; the storefront uses this output. This screen is used by e-commerce and content teams responsible for storefront layout.

This document describes both the menu list and the Menu items page where you manage a menu's items.

Accessing the screen

• In the left menu: Headless CMS › Storefront › Store menus.
• In the Items window opened by the products icon (All products) in the top bar, the Store menus shortcut under the Headless CMS row.
• The menu screen was formerly under PIM; bookmarks saved to the old PIM menu address redirect you automatically to this screen.

If you do not see the menu, your account lacks permission for this screen.

Screen sections

1. Page title Store menus, subtitle Navigation menus on the storefront and their publishing templates. Top right New menu button.
2. Menu table. All menus appear in a single list; no filtering, search, or pagination. If no menu is defined, No records found and No menu defined yet. are shown.

List

The buttons in the Actions column, from left to right:

Icon buttons show their name as a tooltip on hover.

• Tree icon Menu items — opens the page to manage the menu's items.
• Pencil icon Edit — opens the menu record in an edit window.
• Rocket icon Publish — publishes the menu. Disabled if no Menu template is selected.
• Published output — visible only if the menu has been published at least once.

Actions

Adding a new menu

1. Click the New menu button at the top right.
2. Fill in the fields in the opened window (field table below).
3. Click Save.

If successful, the window closes, a Menu saved. notification appears, and the list refreshes. If failed, a red Something went wrong notification appears and the window remains open with your entered values. Menu name is required; Save is disabled if empty or only spaces. The Live checkbox is unchecked by default for new menus.

Editing a menu

1. Click the pencil icon (Edit) in the menu's row.
2. The window opens titled Edit; fields are prefilled with the menu's current values.
3. Make changes and click Save. To cancel, click Cancel or close the window.

Changes in the menu record (e.g. changing the template) do not automatically update the published output. To reflect changes on the storefront, republish the menu.

Publishing a menu

Used to push changes in menu items or the menu's template to the storefront.

1. Ensure the menu has a Menu template selected (if not, the rocket button is disabled).
2. Click the rocket icon (Publish) in the row.

No confirmation is asked; the process starts immediately. Publishing uses the menu's saved template. If successful, a Menu published. notification appears, the list refreshes, and the Publishing column shows the new date. While publishing, all publish buttons are disabled. Publishing cannot be undone from the screen.

Viewing published output

1. Click the Published output button in the row.
2. The opened window shows the menu's most recent published output in fixed-width font.

The window is read-only; you can select and copy text but cannot edit. Output is not edited here; it is generated from items and template.

Going to menu items

Click the tree icon (Menu items) in the row. The menu's items page opens (described below).

Statuses

Menu items page

This page manages a menu's links, order, localized names, and template variable values. The page title shows the menu's name; subtitle reads Links in the menu, their order, localized names, and template variable values. Top left Store menus button returns to the menu list. Top right has New item button, and when order is changed, a Save order button appears.

Item list

All items, including subitems, appear in a single flat list; hierarchy is tracked by the full path under Item name. If no items exist, No records found and This menu has no item yet. are shown.

Changing item order

1. Click the up arrow (Move up) or down arrow (Move down) button in the item's row to move it one position in the list. Repeat until desired order is reached.
2. After the first move, the Save order button appears at top right. Click it.

If successful, a Order saved. notification appears and the Save order button disappears. The order is saved by numbering items from top to bottom as shown.

• Moving changes only order; it does not change the item's Parent item link. To move an item under a different parent, edit the item and change the Parent item field.
• The topmost item cannot move up, and the bottommost cannot move down.

Moves only persist after clicking Save order. Leaving the page without saving loses changes. After saving, republish the menu to reflect changes on the storefront.

Adding and editing items

1. For a new item, click New item; to edit an existing item, click the pencil icon (Edit) in its row.
2. The window opens with three tabs: Definition, Localized names, Template values. The number next to Localized names is the count of languages defined in the system (not the count of entered translations); the number next to Template values is the count of values entered for this item.
3. Fill in fields on the Definition tab.
4. Click Save.

If successful, the window closes and a Item saved. notification appears. If failed, a red Something went wrong notification appears and the window remains open. Item name is required; Save is disabled if empty. The window title is New item for new items, or the item's name when editing. The Save button at the bottom saves only fields on the Definition tab.

To enter localized names or template values for a new item, first fill the Definition tab and click Save. The window closes; then reopen the item with the pencil icon and switch to the other tabs.

Definition tab

Only image files can be selected. When an image or icon is selected, the file uploads immediately, a File uploaded. notification appears, and the file path appears below the field. Both fields are disabled during upload. The file is linked to the item only after clicking Save; closing the window without saving keeps the old image.

Localized names tab

Enter the item's name separately for each language. This tab works only for saved items; for new items it shows Save the item first and Translations and template values attach to a saved item.

1. Each defined language is listed with its name; boxes for languages without entered names are empty.
2. Enter the name in the box for the relevant language.
3. Click Save on the same row.

If successful, a Translation saved. notification appears. Each row saves separately with its own Save button; the Cancel button at the bottom does not undo saved translations, nor does the bottom Save save unsaved rows.

Template values tab

Assign values for variables defined in the menu template to this item (variables are defined on the Menu templates screen). This tab also works only for saved items.

Existing values are listed with columns Variable, Section, Value, and Actions; the Section column shows the section ID. If none exist, No template value for this item. is shown.

To add a new value:

1. Select a variable from the Variable dropdown below. The list shows variables from the menu's selected template.
2. Optionally select a Section.
3. Enter the value in the Value box.
4. Click Add. The Add button is disabled if no variable is selected.

If successful, a Value saved. notification appears, the value is added to the table, and the input fields clear. To delete a value, click the trash icon in its row; a Value deleted. notification appears. Deletion does not ask for confirmation.

Deleting an item

Click the trash icon (Delete) in the row. No confirmation is asked, the item is deleted immediately, and an Item deleted. notification appears. Deletion cannot be undone; if deleted by mistake, you must add the item again.

Deletions, additions, and edits only reflect on the storefront after republishing the menu.

Common situations

Rocket (Publish) button is disabled. No template is selected for the menu. Edit the menu, select a template in the Menu template field, and save. If no templates exist, first create one on the Menu templates screen.

I changed items but they don't appear on the storefront. The storefront uses the menu's published output. Return to the menu list and click Publish in the menu's row; verify the Publishing column date updates.

Variable list in Template values tab is empty. No template is selected for the menu or the selected template has no variables. Check the menu's template and variables on the Menu templates screen.

Red "Something went wrong" notification appeared. Saving, deleting, publishing, or file uploading failed; the reason is shown below the notification. Since the save window remains open, you do not lose your input; fix the issue and try again.

I cannot remove an item's image or icon. There is no option to clear the image or icon on screen; you can only replace it by selecting a new file.

I want to delete a menu. There is no menu deletion on this screen. You can distinguish unused menus by unchecking Live.

"PIM service not configured." appears on screen. Your environment is not connected to menu data. This cannot be resolved on your side; notify your system administrator.

"Something went wrong" appears. The list failed to load. Click Retry; if the problem persists, send the text under Technical detail to your system administrator.

Related screens

• Menu templates
• Categories
• Localization
• Overview