> ## 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.

## The monitor switch is missing

Check **Theme settings → Colors → Show the color mode switch**, and that the [Utility bar](https://docs.kwebby.com/kelvin/sections/utility-bar.md) is not hidden in the Header group. The switch also shows on the password page. On phones the utility bar holds only the switch, so with the switch off the bar is hidden there.

## My store opens in the wrong mode

While the switch is shown, the store uses the visitor's own choice first, then **Theme settings → Colors → Default color mode**. If you clicked the monitor yourself, your browser remembers that choice: click it until it shows the default mode, which clears it. With Auto, the store follows each device's light or dark setting. See [Light and dark mode](https://docs.kwebby.com/kelvin/guides/light-and-dark-mode.md).

## A section looks wrong in dark mode

Each section takes its colors from its Color scheme, and each scheme has a separate dark palette. Open **Theme settings → Colors**, edit that scheme's dark colors (the settings that start with Dark mode), and check the page in both modes.

## Product cards show no spec rows

Spec rows come from product metafields in the namespace `specs`. Check that the key is listed in **Theme settings → Product cards → Spec rows** exactly as written in the metafield definition, that the product has a value, and that **Spec rows on cards** is above 0. See [Spec rows](https://docs.kwebby.com/kelvin/guides/spec-rows.md).

## Compare boxes do not show

Compare boxes on cards, the hero, quick view and the product page show only once a compare page is chosen. Create a page with the `page.compare` template and choose it in **Theme settings → Compare → Compare page**; check **Compare checkbox** in **Theme settings → Product cards** too. See [Compare](https://docs.kwebby.com/kelvin/guides/compare.md).

## The PC Builder shows no parts, or Add to a PC build is missing

* Create a page with the `page.pc-builder` template and choose it in **Theme settings → PC Builder → PC Builder page**.
* In the [PC Builder](https://docs.kwebby.com/kelvin/sections/pc-builder.md) section, each Slot block needs a Parts collection that holds products.
* Add to a PC build shows only on products with the tag in **Theme settings → PC Builder → Parts tag** (`pc-part` on install).
* Compatibility checks need the parts' `specs` metafields. See [PC Builder](https://docs.kwebby.com/kelvin/guides/pc-builder.md).

## Stars do not show on cards

Card stars read the `reviews.rating` and `reviews.rating_count` metafields that a reviews app writes. Without an app, cards show no stars; check **Theme settings → Product cards → Show rating** too.

## My reviews do not show on the product page

Reviews come from the product metafield `custom.reviews`, a list of Product review entries. Check that the entries are published, that they are added to the product's metafield, and that **Show the product's reviews** is on in the Below: reviews block. See [Product reviews and Verified purchase](https://docs.kwebby.com/kelvin/guides/product-reviews.md).

## Care+ plans are not offered

Add the plan products to the product's `custom.protection_plans` metafield, and make sure each plan product is active and available on the Online Store. The Protection plans block must be in [Product information](https://docs.kwebby.com/kelvin/sections/product-information.md). See [Care+ protection plans](https://docs.kwebby.com/kelvin/guides/care-plus-protection-plans.md).

## The gift box is not on the Deals menu item

The gift box goes on the menu item whose title matches **Theme settings → Deals → Deals menu item** exactly (Deals on install). Check **Animate the gift box** too. See [Deal highlights](https://docs.kwebby.com/kelvin/guides/deal-highlights.md).

## The deal countdown does not appear

The Deal countdown needs **Deal ends** as a date and time 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 section. It is also hidden on install until you show it. See [Deal countdowns](https://docs.kwebby.com/kelvin/guides/deal-countdowns.md).

## 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. The films must be uploaded to Shopify. See [Vertical films](https://docs.kwebby.com/kelvin/guides/vertical-films.md).

## 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/kelvin/guides/search-and-discovery-filters.md).

## Frequently bought together or the cart suggestions are empty

Both use complementary products from the Search & Discovery app. Add them per product in the app's Product recommendations. The cart falls back to the collection in **Theme settings → Cart → Suggested products**.

## 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 store](https://docs.kwebby.com/kelvin/guides/pickup-in-store.md).

## Gift wrapping or the gift message does not show in the cart

Choose a product in **Theme settings → Cart → Gift wrapping product**; leave it empty to hide gift wrapping. The gift message field shows once gift wrapping is in the cart. See [Gift wrap, gift message and order notes](https://docs.kwebby.com/kelvin/guides/gift-wrap-and-cart-extras.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 Age verifier and Promo popup live only in the Overlays group, and Related products only on product pages. The cart drawer, the compare tray and quick view are not sections you add: they are set in Theme settings.

## The free shipping bar or the Pay in 4 line does not show

Both are off on install. Turn on **Theme settings → Cart → Show free shipping progress** and set **Free shipping over** to match your shipping rates; the bar shows only for carts in your store currency. The Pay in 4 line needs **Theme settings → Product cards → Show the Pay in 4 line**, Shop Pay as a payment method, and a price or cart total at least **Pay in 4 minimum price**.


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