Docs
FAQ and troubleshooting

Troubleshoot product and collection pages

Fix common Combine product and collection page problems: swatches, icons, badges, filters, quick buy and the sticky add to cart.

Applies to: Combine 4.2.0 and later. Added in: Combine 1.0.0. Last checked: 2026-10-13 against Combine 4.2.0.

Use this page when something on a product page or in a product grid does not show as expected. Each answer names the setting to check and links to the page that explains it.

Why does my color option not show as swatches?

Because the option name is not in Color swatches labels, or Show color swatches is off. Check these in order:

  1. Theme settings → Product card → Product variants → Show color swatches is on (product grids).
  2. The option name, in lower case, is in Color swatches labels. For an option "Shade", add shade.
  3. The labels have no space after the commas: color,shade, not color, shade. A label with a leading space never matches.
  4. On the product page, Featured product and Quick view, Show color swatches is also on in the Variant picker block.

Options whose values have Shopify swatches become swatches whatever their name. See Color swatches.

Why is a swatch empty or the wrong color?

Because Combine found no color for that value. It uses the first of these that exists:

  1. The Shopify swatch image.
  2. The Shopify swatch color.
  3. An image named after the value in Content → Files (dark-grey.png for "Dark Grey").
  4. The value as a web color name.

A value such as "Midnight" is not a web color: upload a PNG with that name or set a Shopify swatch.

Why do icons not show in my product cards?

Because one link of the chain is missing. Check these in order:

  1. The grid has an Icons list block (each grid section has its own blocks).
  2. Theme settings → Product card → Dynamic icons list → Icon 1 has the metafields typed as namespace.key in Icon metafield and Label metafield. These are text fields: do not connect them as dynamic sources.
  3. The icon metafield is a File (image) metafield and the label metafield is Single line text.
  4. The product has values in those metafields.

Without an icon image, Combine looks in Content → Files for a PNG named after the label (gentle-calming.png for "Gentle calming"). See Dynamic icons list.

Why do my filters not show?

Because Enable filtering is off, or no filters exist in Shopify's Search & Discovery app. Filters are a Shopify feature: install the app, add filters in it, then turn on Enable filtering in Collections → Default collection → Product grid. See Collection page.

Why does the quick buy button not show, or not open a window?

Because of the Quick buy block settings of that grid:

  • The grid has no Quick buy block. Add it to each grid section that needs it.
  • Don't show quick buy if product is out of stock is on and the product is sold out.
  • Options display type is Inline, so the options show in the card instead of a window. Set it to Modal (on click) to open the Quick view.
  • The product has no variants. Quick buy then adds it to the cart directly.

See Product grid blocks.

Why does the quick buy popup not show after adding to cart?

Because the quick buy popup works only for products added from product grids, not from the product page. Check that Theme settings → Product card → Quick buy popup → Enable quick buy popup is on. See Product card theme settings.

Why does my custom badge not show?

Because the product does not have the exact tag. Theme settings → Product card → Custom badge 1 (2, 3) shows the badge on products whose tags contain the Tag value, written exactly the same, case included. Check Show badges too. See Product badges theme settings.

Why does the discount badge say "On Sale" instead of a percentage?

Because the product's variants have different prices or compare-at prices. Since Combine 3.2.2, product grids show the generic "On Sale" badge for such products, which keeps collection pages fast. The Product badges block on the product page shows the exact saving of the selected variant.

Why does my sticky add to cart not show?

Because Enable sticky add to cart is off, the product is sold out, or the main add to cart button is still on the screen. On desktop the bar appears only after the add to cart button has scrolled above the top of the screen. See Product page.

Why do customers not see the compare checkbox?

Because Enable comparing is off in the collection's Product grid, or the customer has not turned on the Compare switch in the filtering bar. Comparing exists only on collection pages. See Product comparison page.

Why does the product image not change when a customer selects a color?

Because the variant has no image, or Change product image based on selected variant is off. Assign an image to each variant in Shopify admin → Products, and turn the setting on in Theme settings → Product card → Product variants. Product cards that show a video do not change their image.

Troubleshoot popups

Fix Combine popups, cookie banner, age verification and exit intent popup that do not show, show too often or show all at once.

What Combine does not do

What Combine does not do: the limits of the theme, which ones Shopify controls, and what to use instead.

On this page

Why does my color option not show as swatches?Why is a swatch empty or the wrong color?Why do icons not show in my product cards?Why do my filters not show?Why does the quick buy button not show, or not open a window?Why does the quick buy popup not show after adding to cart?Why does my custom badge not show?Why does the discount badge say "On Sale" instead of a percentage?Why does my sticky add to cart not show?Why do customers not see the compare checkbox?Why does the product image not change when a customer selects a color?Related pages