# Troubleshooting and questions

> Answers to common Kera questions, from missing filters and checkout buttons to free gifts, badges, headers and custom code.

Source: https://spellnsell.com/themes/kera/docs/help/troubleshooting · Kera 1.0.0 · Updated 2026-11-14

Open a question to see the answer. Not here? Contact us through the [support page](https://spellnsell.com/themes/kera/support).

Most asked: [Collection page and filters](https://spellnsell.com/themes/kera/docs/collections/collection-page) · [Free shipping bar and free gift](https://spellnsell.com/themes/kera/docs/cart/free-shipping-and-gift) · [Metafields the theme reads](https://spellnsell.com/themes/kera/docs/store-data/metafields) · [Update the theme](https://spellnsell.com/themes/kera/docs/help/updating)

## Product page

:::details Why don't the express checkout buttons show?
Turn on **Show dynamic checkout buttons** in the **Buy buttons** block (for the cart, in **Theme settings > Cart**). Only methods turned on in **Settings > Payments** appear, and each customer sees the one that suits them, so yours may differ.
:::

:::details How do I show a different photo for each metal?
Give each variant its own image in Shopify admin. See [Media gallery and full-screen viewer](https://spellnsell.com/themes/kera/docs/product-page/media-gallery).
:::

:::details Why does a photo disappear when I pick a variant?
**Selected variant photos only** is on. A variant shows its own image plus the photos after it, up to the next variant's image. Add `#all` to a photo's alt text to keep it for every variant. See [Labels in square brackets](https://spellnsell.com/themes/kera/docs/store-data/labels).
:::

:::details Why are the full-screen viewer's controls hard to see?
In the **Media gallery** block, turn on **Full-width control buttons** and pick a **Controls color scheme**. They appear when **Image size** is **Full width** or **Show an image size button** is on.
:::

:::details Why does the size guide open the wrong page?
The product's `custom.size_guide` metafield and a page named after its product type come before the block's page. See [Size guides](https://spellnsell.com/themes/kera/docs/product-page/size-guides).
:::

:::details Why is Related products empty?
Shopify picks them from your sales and catalog, so a new store may show few or none. Choose them yourself with Search & Discovery's product recommendations.
:::

:::details Why does Complete the stack show nothing?
Pick products in the block, or set complementary products in Search & Discovery. See [Complete the stack and related products](https://spellnsell.com/themes/kera/docs/product-page/complete-the-stack).
:::

## Product cards and badges

:::details Why do Worn and Still show the same photo?
Still is the first image and Worn the second. Add a worn photo or reorder the media. See [Worn / Still toggle](https://spellnsell.com/themes/kera/docs/collections/worn-still).
:::

:::details Why doesn't the New badge show?
The tag must be exactly `new` and **Show new and last pieces badges** on in **Theme settings > Badges**. Sold out and Sale badges come first. See [Product and article tags](https://spellnsell.com/themes/kera/docs/store-data/tags).
:::

:::details Why doesn't my metafield badge show?
Enter `namespace.key`, such as `custom.badge`, in **Badge metafield** (**Theme settings > Badges**); it installs empty. See [Metafields the theme reads](https://spellnsell.com/themes/kera/docs/store-data/metafields).
:::

:::details Why doesn't the quick add button show?
Check **Show quick add** in **Theme settings > Quick add**. With **Show the button** set to **On hover (desktop)**, it appears on pointing. One-variant products go straight to the bag; others open quick view.
:::

## Collections and search

:::details Why don't my filters show?
Add them in Shopify's Search & Discovery app. See [Collection page and filters](https://spellnsell.com/themes/kera/docs/collections/collection-page).
:::

:::details Why doesn't the Worn / Still toggle show?
It needs **Show worn and still toggle** on in the **Collection** section and a product with a second photo. Force it per collection with the `custom.view_toggle` metafield (true or false).
:::

## Cart and checkout

:::details Where do customers enter a discount code?
At checkout. To add a field in the cart, turn on **Show discount code field** in **Theme settings > Cart**.
:::

:::details Why doesn't the progress bar show?
**Show progress bar** in **Theme settings > Cart** installs off. See [Free shipping bar and free gift](https://spellnsell.com/themes/kera/docs/cart/free-shipping-and-gift).
:::

:::details Why does checkout charge shipping when the bar says free?
The bar is a message only. Create a free shipping rate with the same minimum in **Settings > Shipping and delivery**.
:::

:::details Why isn't the free gift free at checkout?
The price comes from an automatic **Buy X get Y** discount you create. See [Free shipping bar and free gift](https://spellnsell.com/themes/kera/docs/cart/free-shipping-and-gift).
:::

:::details Why doesn't the free gift picker appear?
**Free gift over an amount** installs off, and it needs a **Gift collection** with products. See [Free shipping bar and free gift](https://spellnsell.com/themes/kera/docs/cart/free-shipping-and-gift).
:::

:::details Why is my Build a set full price?
The section only shows the **Set discount** percentage. Create the matching automatic discount. See [Build a set and its discount](https://spellnsell.com/themes/kera/docs/jewelry-tools/build-a-set).
:::

:::details Why does adding go to the cart page instead of the drawer?
Check **Cart type** and **After adding to the bag** in **Theme settings > Cart**. If the **Cart drawer** section was removed from Overlays, the theme uses the cart page.
:::

## Header and menus

:::details Why isn't the header transparent on the home page?
Turn on **Transparent on home page** in the **Header** section. It works only over a full-width image, slideshow or video that is the first section with no top spacing.
:::

:::details How do I pause or slow the announcement bar?
Turn on **Show pause button**, raise **Scroll speed** (seconds per loop), or set **Layout** to **One message at a time** and change **Time per message**.
:::

:::details How do I add a "New" badge to a menu link?
Add it in square brackets to the link name in **Online Store > Navigation**, such as `Rings [New]`. See [Labels in square brackets](https://spellnsell.com/themes/kera/docs/store-data/labels).
:::

:::details Why is there no account icon?
Customer accounts are off in **Settings > Customer accounts**. See [Customer accounts](https://spellnsell.com/themes/kera/docs/pages/accounts).
:::

:::details Why doesn't the country or language selector show?
It needs more than one country (**Settings > Markets**) or published language (**Settings > Languages**). See [Translations and languages](https://spellnsell.com/themes/kera/docs/reference/translations).
:::

## Pages and blog

:::details Where do contact form messages go?
To your store's contact email in **Settings > General**. See [Contact page and store locator](https://spellnsell.com/themes/kera/docs/pages/contact-and-store-locator).
:::

:::details Why do the blog tabs show the wrong types?
**Types** in the **Blog** section comes with examples. Use your article tags, or clear it to use all. See [Journal and articles](https://spellnsell.com/themes/kera/docs/pages/journal).
:::

:::details Why doesn't the password work in the editor?
The editor stays on the password page. Test in a private browser window. See [Password page](https://spellnsell.com/themes/kera/docs/pages/password).
:::

:::details Why don't my account template changes show?
Your store probably uses new customer accounts, which Shopify hosts. See [Customer accounts](https://spellnsell.com/themes/kera/docs/pages/accounts).
:::

## Apps and custom code

:::details How do I add app code without an app block?
Paste it in a **Custom Liquid** section, or a **Custom Liquid** block on the product page, Featured product section, cart drawer or cart page.
:::

:::details Why doesn't the bag update after an app adds to it?
Send [Developer reference](https://spellnsell.com/themes/kera/docs/reference/developer-events) to the app's developer.
:::

:::details Can I edit the theme code?
Yes, on a duplicate (**Online Store > Themes > ... > Duplicate**). Code changes aren't covered by support or carried into new versions. See [Update the theme](https://spellnsell.com/themes/kera/docs/help/updating).
:::

:::details I filled in a metafield but nothing shows.
The namespace and key must match exactly. See [Metafields the theme reads](https://spellnsell.com/themes/kera/docs/store-data/metafields).
:::

:::details Why did a template stop working after I removed a metafield definition?
A setting connected to a missing definition can stop Shopify showing the template. Recreate the definition or disconnect the dynamic source.
:::
