Troubleshooting
Step-by-step checks for the most common issues: widgets not showing, changes not appearing, and disabled option values.
Last updated
Was this helpful?
Step-by-step checks for the most common issues: widgets not showing, changes not appearing, and disabled option values.
Work through this checklist in order:
Check the Home app status card. If it says inactive, enable the app embed on your published theme. This is the #1 cause.
Draft and archived groups never render. Check the group's status on the Groups index.
An option's appearance can be Hidden per surface (product page vs. card). Open the group and check the Appearance settings.
Your theme may need a tuned integration — see Theme compatibility and contact support with your product page URL.
Saves publish asynchronously and Shopify's CDN caches the data file. Expect up to a few minutes of delay; a hard refresh (Cmd/Ctrl+Shift+R) usually reveals the update.
A value is disabled when its linked product is unavailable — deleted, archived, set to draft, unpublished from the Online Store channel, or unlinked from the group. Fix the product's status or relink it in the group editor. The disabled look is controlled by your style's sold-out effect.
Product page: pin it with the product page block.
Small offsets: adjust with Custom CSS.
The editor shows a banner plus inline errors. Common causes: a product already belongs to another group, duplicate value names within an option, or a missing option name. See validation errors.
Check the format and limits: header must include Group and Product ID; max 2 MB / 1,000 rows / 3 options; single-choice groups (sub_groups) aren't importable. Remember the export file is not an import template.
Last updated
Was this helpful?
Was this helpful?