Troubleshooting
Resolve missing effects, sync errors and publication problems.
My badge, icon or link colour is missing
- Enable the app embed on the active theme and save it.
- Ensure the menu is enabled in MenuFields.
- Save the item and choose Publish menu.
- Refresh the storefront and check that the theme renders the intended menu and destination.
- Check both desktop navigation and the mobile drawer.
If the embed status appears correct but nothing renders after an extension update, toggle the embed off, save, then on and save again. For custom markup, see Theme integration.
The app asks me to sync before publishing
The Shopify menu changed or its freshness could not be confirmed. Use Sync now, review the current items and publish again. The previous live payload remains in place when publication is blocked.
Required fields prevent publishing
Complete the fields and items named in the error, or configure valid supported defaults. Required fields apply to every menu link. See Custom fields.
Duplicate links prevent publishing
Give conditional links unique labels and destinations. Custom-field data cannot distinguish shared URLs. Appearance-only settings can use shared destinations when labels differ, but identical title-and-destination pairs are ambiguous. See Publishing.
A restricted link appears in the preview
The admin preview keeps links visible for editing. Test the published storefront with the correct login and tag. Reload after account or tag changes. A brief initial flash is possible because visibility enhancements use JavaScript.
An upload fails
Menu icons must be PNG, JPEG or WebP, no larger than 512 KB. Custom-field images accept the same formats up to 5 MB. Check the actual file format, not just its extension. SVG is not supported for these MenuFields uploads.
A Liquid value is blank
Check that the menu is published, the metafield reference came from Developer integration, the field key is correct and the lookup matches the link’s URL. For metaobjects, also check the entry’s storefront availability and actual field keys.
The menu was published but the status is out of date
Use Retry publish when the app offers it to reconcile Shopify’s live data with the app’s local status. Send persistent errors to support.
Uninstalling
Remove MenuFields through Shopify’s app settings. The original Shopify menu structure remains. Review any custom Liquid you added so it handles missing values cleanly. Uploaded Shopify Files may remain because they belong to your store.