Syncing and publishing
Understand drafts, live menus and changes made in Shopify.
Sync, save and publish are different
| Action | Result |
|---|---|
| Sync menus | Refreshes Shopify menu structure in MenuFields |
| Save | Stores an item’s changes as a draft |
| Publish menu | Sends saved menu appearance and custom-field values to Shopify for storefront use |
| Disable the menu | Removes that menu’s MenuFields publication without deleting the Shopify menu |
A Needs publishing status means the menu has saved changes that are not yet live. Unsaved changes must be saved before publishing. Discarding unsaved edits returns to saved values; it is not a rollback of an earlier publication.
Publish a menu
- Check your selected menu and save all changes.
- Resolve missing required custom-field values.
- Check desktop and mobile previews.
- Choose Publish menu and wait for the result.
- Refresh the storefront and verify the links.
Enabling a menu also publishes its saved configuration. Check saved drafts before turning a disabled menu back on. Publish menus individually in the current interface.
When Shopify menus change
If you rename, reorder, add or remove items in Shopify, sync the menu before publishing. The editor checks for source changes and can show a Sync now banner.
Publishing checks freshness again before writing. If the menu has changed, was deleted or cannot be verified, publication stops and the existing live payload is preserved. Sync, review the updated menu and try again.
Sync matches existing items by their Shopify identity and preserves their appearance and custom-field values. A deleted item recreated with the same title or URL is a new item; its previous settings are not guaranteed to return.
Shared destinations
The current implementation can publish appearance for links that share a destination when their labels are distinct. It matches the destination and label rather than relying on visual order.
| Situation within one menu | Behaviour |
|---|---|
| Unique destination | Normal appearance and custom-field publication |
| Shared destination, distinct labels, appearance only | Supported by the current compatible storefront extension |
| Identical label and destination | Ambiguous customised entries block publication |
| Shared destination with custom-field data | Blocked because URL-based Liquid lookup cannot distinguish the items |
| Visibility rule with duplicate destination or label | Blocked to avoid hiding the wrong link |
Do not rely on older guidance that the first duplicate wins. A publish error preserves the existing live menu.
Recovering from a publication error
Follow the message shown in the editor. Fix required values or ambiguous links, sync if requested, then publish again. If Shopify was updated but the local status could not be confirmed, use Retry publish to reconcile the status. For repeated errors, send the message and affected menu to support.