# Product cards and badges

> Set how every product card in Kera looks, which photos it shows, its color swatches, and its Sale, Sold out, New and metafield badges.

Source: https://spellnsell.com/themes/kera/docs/theme-settings/product-cards · Kera 1.0.0 · Updated 2026-11-16

**Where:** Online Store > Themes > Customize > Theme settings > Product cards

Every product grid uses the same card: collection pages, search results, Featured collection, Related products and the rest. Set it once here; sections only choose the products and columns.

![A grid of eight product cards under the heading "Worn every day", with Bestseller, Sale, Made to order, New and Last pieces badges](https://spellnsell.com/themes/kera/img/product-cards.webp)

## Set it up

1. Pick a **Card style**: **Standard**, **Framed** or **Name inside the image**. Installs as **Name inside the image**.
2. Choose **First image**: **Worn** (each product's second image) or **Still (product only)** (the first image). Installs as **Still (product only)**.
3. Pick how **Product images** behave and the **Image aspect ratio**.
4. In **Theme settings > Badges**, choose which badges show and their colors.

:::tip
With **Name inside the image**, a product's `custom.real_size` metafield, such as `12 mm`, shows on the card. See [Metafields the theme reads](https://spellnsell.com/themes/kera/docs/store-data/metafields).
:::

:::sidekick
Open Sidekick in the theme editor and paste this, with your own names. Check the preview, then click **Save**.

```sidekick
In Theme settings > Product cards, set Card style to Name inside the image, Text on the image to Frosted label, First image to Worn, and turn on Show color swatches.
```
:::

## Settings

:::details Product cards
**Card style**: where the name, price and swatches go. Installs as **Name inside the image**.

![The same ring card in each Card style: Standard, Framed, Name inside the image](https://spellnsell.com/themes/kera/img/preview-card-style.webp)

**Text on the image**: with **Name inside the image**, how the name reads on the photo. Installs as **Frosted label**, which stays readable on any photo.

![The ring card with each Text on the image option: Light, Dark, Frosted label](https://spellnsell.com/themes/kera/img/preview-card-inside-text.webp)

**First image**: **Worn** shows each product's second image, **Still (product only)** the first. Installs as **Still (product only)**. Shoppers can switch with the [Worn / Still toggle](https://spellnsell.com/themes/kera/docs/collections/worn-still).

![The ring card with First image set to Worn, showing the ring on a hand, and Still, showing the ring alone](https://spellnsell.com/themes/kera/img/preview-card-first-image.webp)

**Product images**: what the card does under the pointer. Installs as **Second image on hover**. **Main image only** never changes. **Gallery** adds arrows on desktop and swipe on phones, up to 10 images. **Follow the mouse** picks the image from the pointer's position.

![The ring card before and under the pointer with Second image on hover](https://spellnsell.com/themes/kera/img/preview-card-hover.webp)

**Play videos**: when a product's first media is a video uploaded to Shopify, the card plays it muted on a loop while the card is on screen. When the second media is a video, it plays muted on a loop while the pointer is over the card, wherever the card shows that image: as the first image with **First image** set to **Worn**, as the image that comes in with **Second image on hover**, and as the second photo in **Gallery**. It starts over on each hover and goes back to its image when the pointer leaves. Touch screens and shoppers who ask their device for reduced motion see the image. Installs on.

**Image aspect ratio**: the shape of every card image. Installs as **4:5 portrait**. **Adapt to image** keeps each photo's own shape.

![The ring card at 4:5 portrait, 1:1 square and 3:4 portrait](https://spellnsell.com/themes/kera/img/preview-card-ratio.webp)

| Setting | What it does |
| --- | --- |
| **Show price on the image** | With **Name inside the image**: shows the price on the photo. Installs on. |
| **Show price and swatches** | With **Name inside the image**, on desktop: **On hover** or **Always**. Installs as **Always**. Phones always show them. |
| **Show photo arrows** | With **Gallery** or **Follow the mouse**, on desktop: **On hover** or **Always**. |
| **Image progress line** | With **Gallery** or **Follow the mouse**: the color of the line under the image showing which photo is in view. |
| **Text alignment** | **Left** or **Center**. Also lines up the name inside the image. |
| **Show vendor** | Shows the product's vendor. Installs off. |
| **Show color swatches** | A swatch for each value of the first option that has swatches, such as Metal, up to 6. Swatches come from Shopify's option swatches or from metal and color names. On phones, cards with the name inside the image hide them. Installs on. |
| **Show star rating** | Stars and the review count under the price, from your reviews app. Shows only on products with reviews; other cards don't change. Installs on. See [Star ratings from a reviews app](https://spellnsell.com/themes/kera/docs/sections/newsletter-and-reviews#star-ratings-from-a-reviews-app). |
| **Open on the matching variant** | On collection and search pages, the card opens on the variant matching the filters in use, or the metal the collection is named after, with its photos and price. Installs on. |
| **Preview swatch photos on hover** | On desktop, hovering a swatch shows that variant's photo. Installs on. |
:::

:::details Badges
**Position on product cards**: the corner for Sale, Sold out, New and Last pieces. Installs as **Top right**. In the quick add button's corner, badges sit above the button. With **Name inside the image**, bottom badges move to the top.

![The ring card with its Sale badge in each corner: Top left, Top right, Bottom left, Bottom right](https://spellnsell.com/themes/kera/img/preview-card-badge-corner.webp)

**Badge size**: on product cards and the product page. Installs as **Small**.

![The Sale badge at Small, Medium and Large](https://spellnsell.com/themes/kera/img/preview-badge-size.webp)

**Wording**: what the sale badge says. Uses the largest saving among the variants.

![The sale badge as Sale, Percentage off showing −22%, and Amount off showing Save €240](https://spellnsell.com/themes/kera/img/preview-sale-wording.webp)

**Metafield badge style**: how a metafield badge looks beside the others. Setting one up is under Good to know.

![A Handmade metafield badge under the Sale badge in each style: Outline, Accent, Solid](https://spellnsell.com/themes/kera/img/preview-meta-badge.webp)

| Setting | What it does |
| --- | --- |
| **Show sale badge** | On products with a compare-at price above the price. |
| **Show sold out badge** | On products with no variant in stock. |
| **Show new and last pieces badges** | New for products tagged `new`, Last pieces for products tagged `last-pieces`. |
| **Background** and **Text** | Each badge type's colors. |
| **Badge metafield** | A product metafield to show as a badge, written as `namespace.key`. Empty on install. |
| **Metafield badge position** | **With the other badges**, or its own corner so it stays clear of them. |
| **Show on product page** | Also shows the metafield badge on the product page. |
| **Position on product page** | **On the image** or **Under the title**. Also used in quick view and the featured product section. |
:::

## Good to know

:::details How do I add a metafield badge, such as "Handmade"?
1. In **Settings > Metafields and metaobjects > Products**, add a product metafield such as `custom.badge` (single line text).
2. On each product, type the badge in it, such as `Handmade`.
3. In **Theme settings > Badges > Badge metafield**, enter `custom.badge`.

| You type on the product | Shoppers see on the card |
| --- | --- |
| `Handmade` in `custom.badge` | ![The ring card's corner with a Sale badge and a Handmade badge under it](https://spellnsell.com/themes/kera/img/preview-meta-badge-one.webp) |

A list metafield shows up to 3 badges. Types and metaobject badge colors: [Metafields the theme reads](https://spellnsell.com/themes/kera/docs/store-data/metafields).
:::

:::details Why don't my cards show star ratings?
The stars come from your reviews app, such as Judge.me, Loox, Okendo, Yotpo or Stamped, through Shopify's standard review fields. A product shows them once it has at least one review and the app has synced its rating. Check that **Show star rating** is on. Setup and the product page block: [Star ratings from a reviews app](https://spellnsell.com/themes/kera/docs/sections/newsletter-and-reviews#star-ratings-from-a-reviews-app).
:::

:::details Why does a card show only one badge?
A card shows one of Sale, Sold out, New and Last pieces at a time. Sold out comes first, then Sale, then New, then Last pieces. A metafield badge shows alongside.
:::

:::details Why does the card show the same photo for Worn and Still?
Still is the product's first image and Worn the second. Add a second photo of the piece being worn, or reorder the product's media.
:::
