Troubleshooting
Answers to the questions merchants ask most.
Swatches show as grey circles or don’t appear
Each option value needs a colour or image. Edit the product’s Color option and set a swatch for each value, or link the option to a colour metaobject under Content → Metaobjects. Cards show swatches only for the first option that has them.
A card swatch doesn’t change the image
With grouping by position, make sure each colour variant has its own featured image. With grouping by alt text, check the tag matches the option name and value exactly.
Filters are missing
Turn on Use filtering in the Product grid section, then choose filters in the Search & Discovery app.
The free shipping bar doesn’t show
Set a Free shipping threshold in Theme settings → Cart. It shows only when the cart has items and is priced in your store currency.
Product rating doesn’t appear
Ratings read the reviews.rating metafield. Install a reviews app that writes it.
The transparent header is hard to read
Switch Transparent background to Frosted band or Gradient fade, raise Minimum background opacity, or set a transparent header text colour or logo.
A mega menu doesn’t open
Menu item must match the heading of a top-level item in your main menu, and that item needs child links. Tabbed and Sub-menu columns need a third menu level.
Text on my hero image is hard to read
Set Text protection to Scrim or Box, raise Overlay opacity, move the content to a calmer part of the image, or add a portrait mobile image.
The countdown shows the wrong time
Enter the end as YYYY-MM-DD HH:MM. It is read in your store’s time zone (Settings → General).
Recommendations are empty
Shopify needs some store activity first, and complementary products are set per product in Search & Discovery. Turn on Fill with related products meanwhile.
Something changed after I added an app
Remove the app block or turn off the app embed under Theme settings → App embeds to confirm, then contact the app developer.