• Swatches Not Appearing on the Storefront

  Problem: Swatches are not visible on the product page or collection page. Solutions: Check if the app embed is activated. Go to the Dashboard and look at the "App embed status" section. If it says "Inactive", click "Activate" and enable the app on your active theme. Check if the app is enabled. Go to Settings and make sure "Toggle app status" is turned on. The status badge should say "Active". If the app is disabled, no swatches will render anywhere on the storefront.Featured

• Visual Settings Not Applying on Storefront

  Problem: Custom visual settings or custom CSS changes appear correctly in the admin preview but do not reflect on the live storefront. Solutions: Make sure changes are saved. Click "Done" in the Customize modal and then save the product group. Closing the modal without confirming may leave changes unapplied. Clear browser cache or use an incognito window. Storefront JavaScript and CSS files can be cached by the browser. Testing in a private window helps confirm whetheFew readers

• Product Card Image Not Changing on Hover

  Problem: Hovering over a swatch on a product card does not change the card’s featured image. Solutions: Enable the feature. Go to Settings and make sure "Change product card image on hover" is turned on. Verify the selected theme type. The app uses theme-specific selectors to locate the product card image element. If the wrong theme type is selected, the image element cannot be found and the swap will not work. Ensure the product has images. The hovered proFew readers

• Product Group Limit Reached

  Problem: You see an error such as: "Product group limit reached" or "You have reached your product group limit. Please upgrade your plan to continue." Solution: Your current subscription plan has reached its maximum number of allowed product groups. To resolve this: Go to Manage plan from the app navigation. Review your current plan usage. Upgrade to a higher plan to increase your product group limit. If you recently deleted groups and still see the error, make sure yFew readers

• Import Settings Fails

  Problem: Importing visual settings shows an error.Few readers

• Translations Not Loading

  Problem: The Translations page shows a warning or fails to load.Few readers

• Swatches Not Appearing on Product Cards (Collection Pages)

  Problem: Swatches appear on the product page but not on collection or grid pages. Solutions: Enable product card swatches. Go to Settings and make sure "Product card swatches" is turned on. Verify the correct theme type is selected. The app relies on theme-specific selectors to detect product cards. If the wrong theme type is selected, it may not be able to locate card elements on collection pages. Use app blocks for product cards. Open Dashboard → "Manage app blocksFew readers

• Swatches Disappearing After Clicking a Variant

  Problem: On the product page, swatches disappear after selecting a native Shopify variant (for example from a dropdown or radio button), or after part of the page refreshes dynamically. Solutions: Check the selected theme type. Some themes replace large parts of the product page DOM when a variant changes. The app includes a built-in re-injection system that detects these changes and restores the swatches. If the wrong theme type is selected, this detection may fail. VerifyFew readers

• AI Features Not Working

  Problem: Magic Fill or AI Customize does not run, shows an error, or displays a limit message. Common Causes and Solutions:Few readers

• Swatches Appearing in the Wrong Position

  Problem: Swatches appear on the page but in an unexpected location, such as below the add to cart button instead of below the product title. Solutions: Select the correct theme type. Go to Dashboard → "Manage app embed" and enable "Show theme types". Make sure your active theme is selected correctly. Choosing the correct theme type helps the app inject swatches into the intended DOM position. Use app blocks for precise positioning. Go to Dashboard → "Manage app blocks" → "Few readers

• Custom Image or Category Button is Disabled

  Problem: The "Set custom image" or "Set category" button is grayed out and cannot be clicked. Solution: These options become available only after the product group has been saved at least once. Click Save to create the product group. After saving, reopen the group in edit mode. The Set custom image and Set category buttons will now be active. Both features are managed through Shopify’s native metaobject editor, where you can upload custom swatch images and aFew readers

• App Embed Status Shows "Unknown" or "Action Needed"

  Problem: The dashboard shows "Action needed" or the theme management modal shows "Unknown" status for a theme.Few readers

• Color Picker Not Working

  Problem: The eyedropper color picker does not pick colors from the product image. Solutions: Activate picking mode first. Click the color swatch button to enter picking mode. The modal heading should change to indicate that you can hover over the image to set the primary or secondary color. Check if the product has an image. If the product does not have an image, the picker cannot extract colors. Upload at least one product image in Shopify, then reopen the color editor.Few readers

• Settings Failing to Save

  Problem: "There was an error saving settings" or "Error saving product group" appears. Solutions: Refresh the page and try again. This is often caused by a temporary network or session issue. Check required fields. Make sure all required fields are filled: Internal name Option name Each product must have an Option value Check plan limits. If you are creating a new group, verify that you have not reached your product group limit underFew readers