> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kwebby.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Fixes for common questions.

## Product cards show no metal swatches

Cards only show swatches set in Shopify: link the Metal option to the Color category metafield and give each entry a color. Check that **Theme settings → Product cards → Show metal swatches** is on. See [Metal swatches](https://docs.kwebby.com/gloaming/guides/metal-swatches.md).

## Add to bag says to choose a size

**Ask shoppers to choose a size** is on in the Variant picker block, so no size is preselected. Untick it to preselect the first available size.

## The countdown does not appear

Countdowns need the end date with a time zone offset, such as `2026-11-30T23:59-05:00`. A date without the offset, in another format, or in the past hides the countdown. See [Honest countdowns](https://docs.kwebby.com/gloaming/guides/honest-countdowns.md).

## The spin wheel does not appear

It needs **Enable spin wheel** ticked, the section shown with the eye icon under Overlays, at least two segments and one prize with a code. A visitor who spun or closed it does not see it open by itself again for **Show again after** days. It never opens by itself on the cart, account, contact or password pages.

## The vertical films do not play

Films play only while the strip is on screen, and never for visitors who ask for reduced motion or save data: they see the posters. Films must be uploaded to Shopify; YouTube and Vimeo links are not used in this section.

## Filters are missing on collection pages

Filters come from Shopify's Search & Discovery app. Install it and add filters, and check that **Enable filtering** is on in the Collection section. See [Filters with Search & Discovery](https://docs.kwebby.com/gloaming/guides/search-and-discovery-filters.md).

## Complete the set or Goes well with is empty

Both use complementary products from the Search & Discovery app. Add them per product in the app's Product recommendations.

## Pickup does not show on product pages

Turn on local pickup for the location in **Settings → Shipping and delivery**, and keep the variant in stock there. See [Pickup in boutiques](https://docs.kwebby.com/gloaming/guides/pickup-in-boutiques.md).

## An event shows in the wrong place or with no date

Event posts need `custom.start` (or a `date:` tag) with a time zone offset, and a place that matches a boutique's city, such as `place:New York`. See [Boutiques and events](https://docs.kwebby.com/gloaming/guides/boutiques-and-events.md).

## A photograph or film does not show

Image and video settings use files from **Content → Files**. If you uploaded the same file twice, Shopify renames the copy (for example `hero_1.jpg`). Choose the right file again in the section's settings.

## A section I want is missing from a page

Some sections can only be added to certain pages or groups. The Spin wheel and Age check live only in the Overlays group, and Product recommendations only on product pages.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.