Changes aren't appearing
Swatch data doesn’t render from the app’s servers - it’s written to Shopify metafields, and your storefront reads it from there. That design keeps swatches fast, but it means every edit takes a sync step before shoppers see it.
How long updates take
Section titled “How long updates take”After you save a change, the app queues metafield updates and works through them. Typical timing:
- A few minutes for most edits - a group save, a swatch recolor, an appearance setting.
- Longer for big changes - editing a swatch used by hundreds of products, a large CSV import, or an automation run spreads writes out to respect Shopify’s rate limits. Large catalogs can take a while.
While group updates are running, the Product groups page shows a sync banner with the number of groups still pending. When it clears, the data is on Shopify.
Rule out your browser first
Section titled “Rule out your browser first”Before anything else, open the page in a private/incognito window or hard-refresh (Cmd+Shift+R / Ctrl+Shift+R). Storefront pages and CDN caches can serve you a stale copy for a few minutes after the data has actually updated - especially right after several edits in a row.
Trigger an update yourself
Section titled “Trigger an update yourself”Each area has its own nudge:
- A group’s swatches - open the group in the app and click Save (no edits needed). Saving re-queues the metafield sync for every product in the group, and any linked groups.
- Variant swatches options - click Sync options on the Variant swatches page to re-import options and values from Shopify. Use this after renaming an option or adding new values in Shopify.
- Appearance settings - re-saving the Appearance page re-writes the settings your storefront reads.
Changes made in Shopify, not in the app
Section titled “Changes made in Shopify, not in the app”Product edits in your Shopify admin - a new title, a new featured image, a status change, updated inventory - reach the app automatically through webhooks, usually within a couple of minutes, and re-sync the affected swatches on their own. If a deleted or unpublished product still shows a swatch, check the Hide inactive products setting - without it, unpublished (but not deleted) products stay in their groups.
Still stale after 10 minutes?
Section titled “Still stale after 10 minutes?”At that point it’s not normal queue time. Occasionally Shopify’s metafield cache holds onto old values and needs a forced re-sync from our side. Contact support with the product URL and what you changed - re-syncing takes us a minute.