# Kera Shopify theme documentation (all guides) > Kera 1.0.0. Exported 2026-11-16. Section-by-section settings are not included here; see https://spellnsell.com/themes/kera/reference/sections.json. --- # Install and first steps > Add Kera to your theme library, preview it, and set up the logo, colors, menus, home page and product page before you publish. Source: https://spellnsell.com/themes/kera/docs/get-started/install · Kera 1.0.0 · Updated 2026-11-14 **Where:** Online Store > Themes Kera is added unpublished, so you can set it up while your current theme stays live. ![The Kera home page: a red announcement bar and a transparent header over a full-screen slideshow reading "Gold for every day"](/themes/kera/img/whats-included.webp "The home page as it installs, once you add images.") ## Set it up 1. Add the theme: in the Theme Store, click **Try theme** on the Kera page. Or in **Online Store > Themes**, click **Add theme > Upload zip file** and choose the `.zip` (don't unzip it). 2. Click **Customize** next to Kera. In **Theme settings > Logo and favicon**, upload your **Logo** and **Favicon**. 3. Set your color schemes in [Colors and color schemes](https://spellnsell.com/themes/kera/docs/theme-settings/colors) and fonts in [Typography](https://spellnsell.com/themes/kera/docs/theme-settings/typography). 4. Build your **Main menu** in **Online Store > Navigation**, then check the **Menu** setting on **Header** and the **Footer** menu block. 5. On the home page, pick content for each section and remove the ones you don't need. Then review the product page and the cart. 6. In the **Overlays** group, edit or hide the **Newsletter popup**. It installs on and shows on the home page. In the **Footer** group, replace the three sample promises in **Icons with text**. 7. Click **Save**, go back to **Online Store > Themes** and click **...** > **Publish** next to Kera. :::warning A section without its content shows placeholder images or empty product cards, on your live store too. Pick the content or remove the section before you publish. ::: ## Good to know :::details Does installing change my products or menus? No. Kera adds sample text and empty image slots only. See [What the theme installs with](https://spellnsell.com/themes/kera/docs/get-started/whats-included). ::: :::details Should I duplicate the theme first? Only before you edit theme code: click **...** > **Duplicate**. Editor settings don't need a copy. ::: :::details What are the logo rules? **Logo width** installs at 60px. The logo is never taller than 40px in the header, and never wider than 120px on phones. Without a logo, the header shows your store name as text. If a header or footer uses a dark color scheme, upload a **Light logo**; without one, the theme shows your logo in white there. A 32 x 32px .png is recommended for the **Favicon**. ::: :::details What should I know about menus? Nest links under a top-level item to give it a dropdown panel. The header installs with **Mega menu** blocks set to the menu items Shop and Gifts; they only apply when your main menu has items with those names. See [Mega menus](https://spellnsell.com/themes/kera/docs/header-footer/mega-menus). ::: :::details Where do social media icons come from? **Theme settings > Social media**. An icon appears only for a link you fill in. ::: --- # What the theme installs with > The style, templates, section groups and sample content Kera has when you add it to your store, and what you need to fill in. Source: https://spellnsell.com/themes/kera/docs/get-started/whats-included · Kera 1.0.0 · Updated 2026-11-15 **Where:** Online Store > Themes > Customize Kera installs with sample text and empty image slots. Your products, images and menus fill the rest. Every template and its sections: [Templates](https://spellnsell.com/themes/kera/docs/reference/templates). ![The Kera home page: a red announcement bar and a transparent header over a full-screen slideshow reading "Gold for every day"](https://spellnsell.com/themes/kera/img/whats-included.webp) ## What you need to fill in 1. Pick images, collections, products and blogs in each section. Until then they show placeholders, on the live store too. 2. Replace the sample headings and messages. 3. Add your links in **Theme settings > Social media**. 4. Turn on the free shipping progress bar and free gift if you want them. Both install off. 5. Connect metafields if you use them. See [Metafields the theme reads](https://spellnsell.com/themes/kera/docs/store-data/metafields). :::note The **Newsletter popup** installs on and shows on the home page. Edit or hide it before you publish. See [Newsletter, popup and reviews](https://spellnsell.com/themes/kera/docs/sections/newsletter-and-reviews). ::: ## Good to know :::details Some sections don't show on the store yet. A few sections need something picked before they show on the store. In the editor they keep their place with a short note: - **Personalization preview** (the engraving studio) needs a product. - **Size comparison** installs with its own sizes. With **Sizes** set to **Product metafield**, it shows only on products that have Size previews. - **Complete the stack** shows when it has pieces to suggest. ::: :::details Can I make my own templates? Yes. In the editor, open the page selector, choose the page type, and click **Create template**. Base it on one of Kera's templates to start with its sections. ::: --- # How the editor is organized > Where Kera's templates, section groups, sections, blocks and theme settings sit in the Shopify theme editor, and how to add and arrange them. Source: https://spellnsell.com/themes/kera/docs/get-started/editor-basics · Kera 1.0.0 · Updated 2026-11-14 **Where:** Online Store > Themes > Customize The **page selector** at the top picks the template, the **sidebar** lists its sections, and the gear icon opens **Theme settings** for the whole store. ## Add and arrange sections 1. In the page selector, choose the template, such as **Home page** or **Products > Default product**. 2. In the sidebar, click **Add section** where you want it and pick from the list. 3. Click a section in the sidebar or the preview, and change its settings in the panel that opens. 4. Drag a section by its handle to move it. Use the eye icon to hide it without deleting it. :::note Sections in a template only appear on pages using that template. To show something on every page, add it to the **Header** or **Footer** group. ::: ## Settings :::details Parts of the editor | Part | What it holds | | --- | --- | | Page selector | The template you are editing. Each template has its own sections. | | Sidebar | The sections on that template, between the section groups that appear on every page. | | Theme settings | Store-wide settings: **Logo and favicon**, **Colors**, **Typography**, **Layout**, **Buttons**, **Shapes**, **Product cards**, **Quick add**, **Badges**, **Drawers and overlays**, **Animations**, **Cart**, **Search**, **Currency format** and **Social media**. See [Every theme setting](https://spellnsell.com/themes/kera/docs/reference/settings). | | App embeds | App features that don't sit in a section. | | Preview | The page, with a desktop and mobile switch. | The **Add section** list groups sections as **Banners**, **Products**, **Collections**, **Shopping tools**, **Storytelling**, **Video and images** and **Utilities and layout**. Every section: [Sections A to Z](https://spellnsell.com/themes/kera/docs/reference/sections). ::: :::details Section groups Section groups appear on every page. Each group's **Add section** list only offers the sections that belong there. | Group | Sections it installs with | | --- | --- | | Header | **Announcement bar**, **Header** | | Overlays | **Cart drawer**, **Quick view**, **Newsletter popup** | | Footer | **Icons with text**, **Footer** | **Cart drawer**, **Quick view** and **Newsletter popup** can only go in **Overlays**. Without **Cart drawer**, Add to bag goes to the cart page. Without **Quick view**, quick add on products with options goes to the product page. The password page has its own groups; open the password template to edit them. ::: :::details Settings most sections share | Setting | What it does | | --- | --- | | **Color scheme** | One of the schemes in **Theme settings > Colors**. | | **Top spacing** | **None**, **Small**, **Medium** or **Large**. Step sizes come from **Theme settings > Layout > Section spacing**. See [Layout, buttons and spacing](https://spellnsell.com/themes/kera/docs/theme-settings/layout-and-buttons). | | **Bottom spacing** | Same steps as **Top spacing**. | ::: ## Good to know :::details How do I use an alternate template? Kera adds templates such as the **engraving** product template and the **about** page template. Open the product, collection or page in the Shopify admin and choose it under **Theme template**. See [Templates](https://spellnsell.com/themes/kera/docs/reference/templates). ::: :::details The editor shows a note in the header that I don't see on the store. Notes like "matches no main menu item" only appear in the editor. A **Mega menu** or **Mobile menu** block names a menu item your menu doesn't have. See [Mega menus](https://spellnsell.com/themes/kera/docs/header-footer/mega-menus). ::: --- # Set up Kera with an AI assistant > Point Claude, ChatGPT or another assistant at the Kera docs so it answers from the real settings, and work with it safely. Source: https://spellnsell.com/themes/kera/docs/get-started/ai-assistants · Kera 1.0.0 · Updated 2026-11-14 Every docs page is also published as plain Markdown. Give an assistant the addresses below and it answers with the exact setting names the theme editor uses, instead of guessing from other themes. ## Set it up 1. Open an assistant that can read web pages. 2. Paste the `llms.txt` address and ask it to answer from those docs with exact setting names and click paths. Add your question. 3. Follow the steps in the theme editor. Each guide's **Where** line is the click path from the Shopify admin. :::warning Never paste passwords, API access tokens or customer data into an assistant. To let someone look at your store, add them as a collaborator in Shopify instead. Duplicate the theme before an assistant changes it. ::: ## The addresses to give an assistant | Address | What it holds | | --- | --- | | `https://spellnsell.com/themes/kera/llms.txt` | An index of every page with a one-line summary. Start here. | | `https://spellnsell.com/themes/kera/llms-full.txt` | Every guide in one file, for assistants that can read a long document at once. | | Any docs address plus `.md` | That page as Markdown, for example `https://spellnsell.com/themes/kera/docs/cart/free-shipping-and-gift.md`. | | `https://spellnsell.com/themes/kera/docs/reference/sections/.md` | One section's settings and blocks, for example `.../reference/sections/gift-finder.md`. | ## Good to know :::details Is there a quicker way to share one page? Each docs page has **Copy page** and **Open in** buttons at the top that hand the page to an assistant in one click. ::: :::details What should I paste? For a setup question, something like this, with your own question at the end: ```text Read https://spellnsell.com/themes/kera/llms.txt and the pages it links to that are relevant. I use the Kera Shopify theme. Answer with the exact setting names and click paths from those docs. My question: how do I add a free gift when an order passes $150? ``` To plan a whole page, ask for a list of sections, then build it in the editor. The full list is [Sections A to Z](https://spellnsell.com/themes/kera/docs/reference/sections). ```text Using https://spellnsell.com/themes/kera/llms.txt, plan a home page for a store that sells gold hoops and engraved necklaces. List the Kera sections in order, what content each needs (images, collections, products), and the settings to change. ``` ::: :::details The answer names a setting I can't find. Ask the assistant which docs page it came from and open that page. Setting names in the docs are checked against the theme on every release. If an answer and these docs disagree, the docs are right for Kera. If the docs are wrong, [tell us](https://spellnsell.com/themes/kera/support). ::: :::details What about Shopify Sidekick? In the admin, Sidekick works with your store's data, such as products, collections and discounts. In the theme editor, it can change theme settings and add Kera's sections and blocks, for example "add a FAQ section under the product information". Nothing applies until you click **Save**. Sidekick can't create metafield definitions, menus or shipping rates yet; ask it to walk you through those. Guides for tasks it can do have a **Do it with Sidekick** box with prompts to copy. Sidekick can also generate new blocks in the theme editor, for example "a block with a care icon and two lines of text". They can go in **Rich text**, **Image with text**, **Product information**, **Featured product** and **Blog post**. This needs the Edit code permission and a purchased theme, not a trial. Generated blocks are your own code, so they don't change when you [update the theme](https://spellnsell.com/themes/kera/docs/help/updating). ::: :::details For developers | Address | What it holds | | --- | --- | | `https://spellnsell.com/themes/kera/reference/sections.json` | Every section and block with setting IDs, labels, types and defaults. | | `https://spellnsell.com/themes/kera/reference/settings.json` | Every theme setting, grouped as the editor shows them. | | `https://spellnsell.com/themes/kera/reference/metafields.json` | The metafields the theme reads, with owner, key and type. | A coding agent should read `sections.json` before changing a template: section and block types, setting IDs and allowed values are all there. Blocks are private to their section (their files start with `_`), so a block type only works in the section that defines it. A template that references a missing metafield definition in a dynamic source breaks, so create the definition first. Work on an unpublished copy, never the live theme. Pull the latest editor changes before editing JSON files, then push and preview. Code changes don't carry over when you [update the theme](https://spellnsell.com/themes/kera/docs/help/updating). See also the [Developer reference](https://spellnsell.com/themes/kera/docs/reference/developer-events). ::: --- # Ready for AI agents > How Kera works with AI agents from the start, for shoppers' assistants on the storefront, Shopify Sidekick in the theme editor and coding agents, with nothing to turn on. Source: https://spellnsell.com/themes/kera/docs/get-started/ai-agents · Kera 1.0.0 · Updated 2026-11-16 Kera works with AI agents as soon as it's installed. Shoppers' assistants can read and use the storefront, Shopify Sidekick can edit the theme with you, and coding agents get a full reference of the theme. There's nothing to turn on and no app to add. ## On the storefront Shoppers increasingly ask an assistant to find a piece, compare prices or put something in the bag for them. Kera gives those assistants the same clear picture a person gets. | What the theme does | What it gives an assistant | | --- | --- | | **Describes each product in structured data.** Every product page lists each variant with its price, currency, stock, SKU and images, plus the brand, category and the star rating when a reviews app rates the product. Articles, breadcrumbs and the store itself (logo, social profiles and site search) are described too. | Exact facts to quote and compare, read the same way search engines read them, instead of guessed from the page. | | **Gives every view its own address.** The chosen variant (`?variant=`), collection filters and sorting, and search results all show in the address bar. | A link straight to "the 18 mm rose gold hoop" or "gold earrings under €200, newest first", which opens exactly that view. | | **Uses real, named controls.** Variant pickers, filters, quantity, **Add to bag** and the bag are standard buttons and form fields with names. This is the same work that makes the theme [accessible](https://spellnsell.com/themes/kera/docs/reference/accessibility). | Agents that act in a browser find **Add to bag** or a size by its name, not by where it sits on the screen, so they keep working when you change the layout. | | **Leaves checkout to Shopify.** The bag hands over to Shopify's checkout, and the theme adds no steps of its own. | Shopify's own channels for shopping assistants read your products and checkout from Shopify directly, and the theme doesn't get in their way. | ## In the theme editor In the theme editor, Shopify Sidekick can change Kera's settings and add its sections and blocks for you, for example "add a FAQ section under the product information". Every setting has a clear name and help text, so Sidekick picks the right one. Nothing changes on your store until you click **Save**. For what Sidekick can and can't do, and prompts to copy, see [Set up with an AI assistant](https://spellnsell.com/themes/kera/docs/get-started/ai-assistants). ## For assistants and coding agents These docs are written to be read by AI as well as people: - `https://spellnsell.com/themes/kera/llms.txt` lists every page with a one-line summary, and `llms-full.txt` holds every guide in one file. - Every docs page is also published as Markdown: add `.md` to its address. Each page has **Copy page** and **Open in** buttons that hand it to an assistant in one click. - `sections.json`, `settings.json` and `metafields.json` list every section, block, setting and metafield with its ID, type and default, so a coding agent can change a template without guessing. Setting names in the docs are checked against the theme on every release. See [Set up with an AI assistant](https://spellnsell.com/themes/kera/docs/get-started/ai-assistants) for the addresses and how to use them safely. ## Good to know :::details Does an assistant need anything from me? No. The structured data, addresses and named controls are part of every page Kera renders, so they're there for every product, collection and article you add. Fill in product details such as SKU, barcode and product category in Shopify, and assistants get those too. ::: :::details Can an assistant buy something without the shopper? No. Kera only shows the shopper's bag and hands over to Shopify's checkout. Payment always happens in Shopify's checkout, under Shopify's rules for who can pay and how. ::: :::details What about WebMCP? WebMCP is a proposed web standard, being tested in Chrome, that lets a page give agents its own named tools, such as "add to bag". Kera doesn't include it yet, because the standard is still changing and browsers don't support it by default. The structured data, addresses and named controls above already work with today's assistants. ::: --- # Colors and color schemes > Edit Kera's four color schemes, pick a scheme per section, and set the sale price and stock message colors. Source: https://spellnsell.com/themes/kera/docs/theme-settings/colors · Kera 1.0.0 · Updated 2026-11-14 **Where:** Online Store > Themes > Customize > Theme settings > Colors A color scheme sets a background, text, buttons and details. Each section picks one, so editing a scheme changes every section using it. ![An image-with-text section in a light color scheme: hands tying a gift box beside the heading "A bag that sells for you" and a button](https://spellnsell.com/themes/kera/img/colors.webp) ## Set it up 1. Open **Theme settings > Colors** and click a scheme. 2. Change its colors. 3. To give a section another scheme, select it and change its **Color scheme**. 4. Click **Save**. :::note The header has two schemes: one in its **Desktop** block and one in its **Mobile** block. Drawers use **Theme settings > Drawers and overlays**; the cart drawer and quick view have their own in **Overlays**. ::: :::sidekick Open Sidekick in the theme editor and paste this, with your own names. Check the preview, then click **Save**. ```sidekick In Theme settings > Colors, change scheme 4's background to #1F3A2E and its text to white, and keep its buttons readable on that background. ``` ::: ## Settings :::details The schemes the theme installs with The same section in each scheme: ![A Visit the atelier band with a heading, text and two buttons in Scheme 1 white, Scheme 2 light grey, Scheme 3 near black and Scheme 4 deep red](https://spellnsell.com/themes/kera/img/preview-schemes.webp) | Scheme | Background | Text | Used on install by | | --- | --- | --- | --- | | Scheme 1 | White `#FFFFFF` | Near black `#070708` | Most sections, header, drawers | | Scheme 2 | Light grey `#F7F7F7` | Near black `#070708` | Softer bands, such as **Icons with text** | | Scheme 3 | Near black `#070708` | White `#FFFFFF` | The footer, the home page's **Collection showcase**, the newsletter popup's teaser | | Scheme 4 | Deep red `#8E1B22` | White `#FFFFFF` | The announcement bar | Edit these four or add more. ::: :::details In each scheme | Setting | What it does | | --- | --- | | **Background** | The section's background. | | **Text** | Body text and headings. | | **Muted text** | Captions, helper text and secondary labels. | | **Borders and dividers** | Lines between items, and field outlines. | | **Links** | Link color. | | **Icons** | Icon color. | | **Accent** | Sale prices when **Sale price** is empty, and small details such as discounts on order pages. | **Primary button** has **Background**, **Label** and **Border**, for Add to bag and other main buttons. **Secondary button** has **Label** and **Border**; its background is the scheme's own. Hover and pressed shades are worked out from the button color. ::: :::details Prices and messages | Setting | What it does | | --- | --- | | **Sale price** | The color of sale prices everywhere. Leave it empty to use each scheme's **Accent**. | | **Success** | In stock, applied discounts and sent forms. Default `#15803D`. | | **Warning** | Low stock. Default `#B45309`. | | **Error** | Sold out and form errors. Default `#DC2626`. | ::: ## Good to know :::details Why does a message color look different on a dark scheme? Where it would be hard to read, the theme shifts it toward the scheme's text color until it's readable. Field outlines are adjusted the same way. ::: :::details Which colors don't come from the schemes? Badges have their own colors in **Theme settings > Badges**, and the quick add + button in **Theme settings > Quick add**. The shade behind an open drawer is in **Theme settings > Drawers and overlays**. ::: --- # Typography > Choose Kera's heading and body fonts, scale their sizes, and set labels in uppercase or sentence case. Source: https://spellnsell.com/themes/kera/docs/theme-settings/typography · Kera 1.0.0 · Updated 2026-11-14 **Where:** Online Store > Themes > Customize > Theme settings > Typography Kera uses one font for headings and one for everything else. Each has a **Size** control that scales its whole set of text styles, so they stay in proportion. ![A campaign banner: a dark photo with the large heading "Heavy gold, light touch" and a pinned product card](https://spellnsell.com/themes/kera/img/typography.webp) ## Set it up 1. Under **Headings**, click **Font** and pick a font from Shopify's font library. 2. Under **Body**, do the same. 3. Move each **Size** to make that set of text larger or smaller. 4. Choose a **Label style**, then click **Save**. :::tip The heading **Font** sets the weight of headings. Pick Inter Light or Inter Medium for lighter or heavier headings in the same family. ::: ## Settings :::details Typography settings **Label style**: buttons, eyebrows, navigation and badges. Installs as **Uppercase**. **Sentence case** shows labels as you typed them. ![The header menu with Label style Uppercase and Sentence case](https://spellnsell.com/themes/kera/img/preview-label-style.webp) **Size** under **Headings**: 80% to 150%, default 100%. ![The collection title Rings at heading Size 80%, 100% and 150%](https://spellnsell.com/themes/kera/img/preview-heading-size.webp) | Setting | What it does | | --- | --- | | **Font** | Under **Headings**: page titles and section headings. Under **Body**: body text, prices, buttons, labels and navigation. Both install as Inter Regular. The bold and italic styles load with it. | | **Size** | Under **Body**: 90% to 120%, default 100%. Phones use smaller sizes, and both sizes apply there too. | ::: ## Good to know :::details Can I upload my own font? Not from the theme settings. **Font** offers the fonts in Shopify's font library. Adding a custom font file needs a code change. ::: :::details How does a section's heading size relate to these? It picks one of the heading styles, such as H2 or H3. **Size** under **Headings** then scales that style, along with all the others. ::: :::details My headings look too heavy after changing the font. Open **Font** under **Headings** and pick a lighter style of the same family, such as Light or Regular. ::: --- # Layout, buttons and spacing > Set Kera's page margins, section spacing, breadcrumbs, carousel arrows, button hover and price, corner shapes and motion. Source: https://spellnsell.com/themes/kera/docs/theme-settings/layout-and-buttons · Kera 1.0.0 · Updated 2026-11-14 **Where:** Online Store > Themes > Customize > Theme settings > Layout Margins, section spacing, buttons and corners for the whole store, in four **Theme settings** groups: **Layout**, **Buttons**, **Shapes** and **Animations**. ![A numbered process list with large headings, Melt, Shape, Set and Finish, separated by thin dividers](https://spellnsell.com/themes/kera/img/layout-and-buttons.webp) ## Set it up 1. In **Theme settings > Layout**, choose **Compact**, **Default** or **Roomy** in **Section spacing**. 2. Set **Page margin** and **Page margin on mobile**. 3. In **Buttons**, pick the **Hover effect** and whether to show the price on Add to bag. 4. In **Shapes**, pick the corners for buttons, fields, badges and card images. 5. To change one gap only, select the section and change its **Top spacing** or **Bottom spacing**. :::note The bottom spacing of one section and the top spacing of the next add up. Two sections with **Medium** on the touching sides have 96px between them with **Default** spacing. ::: ## Settings :::details Layout **Carousel arrows**: the arrows on product photos and carousels. Installs as **White square**. ![The product gallery arrow on a photo in each style: Arrow only, White square, Blurred](https://spellnsell.com/themes/kera/img/preview-arrows.webp) | Setting | What it does | | --- | --- | | **Show breadcrumbs** | Home / Rings above page titles. Installs on. | | **Page margin** | Left and right space on tablets and up. 16 to 80px, installs as 40px. | | **Page margin on mobile** | The same on phones. 12 to 32px, installs as 16px. | | **Section spacing** | How big Small, Medium and Large spacing are, below. | | Section spacing | Small | Medium | Large | | --- | --- | --- | --- | | **Compact** | 16px | 32px | 48px | | **Default** | 24px | 48px | 64px | | **Roomy** | 32px | 64px | 96px | Phones use about 70% of these. ::: :::details Buttons **Hover effect**: what Add to bag and other buttons do under the pointer. Installs as **Wipe**. ![The Add to bag button under the pointer with each hover effect: Wipe, Fade, None](https://spellnsell.com/themes/kera/img/preview-button-hover.webp) **Two-tone price panel** and **Panel shade**: the price sits on a panel one shade off the button. Installs off, shade 10% (2 to 30%). ![The Add to bag button with Two-tone off, on with Panel shade 10%, and with 30%](https://spellnsell.com/themes/kera/img/preview-two-tone.webp) | Setting | What it does | | --- | --- | | **Show the price on the button** | The price at the left of every Add to bag button, as above. Installs on. | Button colors come from the color scheme: see [Colors and color schemes](https://spellnsell.com/themes/kera/docs/theme-settings/colors). ::: :::details Shapes All four install as **Square**. The product gallery, drawers and full-width images stay square. **Buttons**: also quantity and option buttons. ![The Add to bag button with Square, Slightly rounded, Squircle and Pill corners](https://spellnsell.com/themes/kera/img/preview-buttons.webp) **Fields and rows**: also dropdowns and drawer rows. ![An email field with Square, Soft and Rounded corners](https://spellnsell.com/themes/kera/img/preview-fields.webp) **Badges**: Sale, Sold out, New and labels. ![A New badge on a product photo with Square, Soft and Pill corners](https://spellnsell.com/themes/kera/img/preview-badges.webp) **Card images**: product, collection, article and menu cards. ![A product card with Square, Soft and Rounded image corners](https://spellnsell.com/themes/kera/img/preview-card-images.webp) ::: :::details Animations **Roll prices when they change**: the digits roll to the new price when a shopper picks another variant. Installs on. Visitors who turn off motion on their device see the new price without the roll. ![The price on a product page rolling from €495,00 to €120,00 when a shopper picks another size](https://spellnsell.com/themes/kera/img/preview-price-roll.webp) **Zoom images on hover**: card images grow slightly under the pointer. Installs on. ::: ## Good to know :::details Can I hide breadcrumbs on one page only? **Show breadcrumbs** applies to the whole store. Some sections, such as **Collection banner**, have their own breadcrumbs setting. ::: --- # 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. ::: --- # Quick add and quick view > Turn on Kera's quick add button on product cards, style it, and set up the quick view drawer that opens for products with options. Source: https://spellnsell.com/themes/kera/docs/theme-settings/quick-add · Kera 1.0.0 · Updated 2026-11-14 **Where:** Online Store > Themes > Customize > Theme settings > Quick add A + button on product cards. A product with one choice goes straight into the bag; a product with options opens quick view, a drawer with photos, options and Add to bag. ![A collection page with the quick view drawer open: "Choose options" for Knot ring, with metal swatches, size buttons, quantity and Add to bag](https://spellnsell.com/themes/kera/img/quick-add.webp) ## Set it up 1. In **Theme settings > Quick add**, turn on **Show quick add**. 2. Choose **Show the button**, **Position**, **Style** and the button colors. 3. Under **Quick view**, set **Option style** to match the product page. 4. In the sidebar, under **Overlays**, select **Quick view** and set its **Color scheme**, **Show product media** and **Show link to full details**. :::note **Option style** can't read the product page's **Variant picker** block, so set the same style yourself. See [Variant picker and size help](https://spellnsell.com/themes/kera/docs/product-page/variant-picker). ::: ## Settings :::details Theme settings > Quick add **Style**: the + button's shape. Installs as **Square**. **Blurred** shows the Background color see-through over the image. ![The quick add button on a card photo in each style: Square, Squircle, Blurred](https://spellnsell.com/themes/kera/img/preview-quick-add-style.webp) | Setting | What it does | | --- | --- | | **Show quick add** | Shows the + button on product cards. Installs on. | | **Show the button** | **On hover (desktop)** or **Always**. Installs as **On hover (desktop)**. Touch screens without hover show it either way. | | **Position** | **Bottom right** or **Bottom left** of the card image. Installs as **Bottom right**. | | **Background** | Installs white. | | **Icon** | The + color. Installs near black. | | **Hover background** | Installs near black. | | **Hover icon** | Installs white. | | **Option style** | Options in quick view: **Buttons**, **Color circles**, **Variant images**, **Variant tiles**, **Squares** or **Dropdown**. Installs as **Squares**. | ::: :::details Quick view section | Setting | What it does | | --- | --- | | **Color scheme** | The drawer's colors. | | **Show product media** | The product's photos at the top of the drawer, up to 8. | | **Show link to full details** | Adds a link to the product page. | ::: ## Good to know :::details When does the + button add straight to the bag? When the product has a single variant, doesn't require a subscription, isn't a gift card and doesn't use the **engraving** template. Otherwise it opens quick view, since those need a choice first. Sold-out products have no button. After an add, the store follows **Theme settings > Cart > After adding to the bag**. ::: :::details The + button opens the product page instead of quick view. The **Quick view** section is missing from the **Overlays** group. Add it back with **Add section**. Without it, product links in other drawers go to the product page too. ::: --- # Drawers and overlays > Set the colors of Kera's product and filter drawers, how the page looks behind them, and the store-wide size guide page. Source: https://spellnsell.com/themes/kera/docs/theme-settings/drawers-and-search · Kera 1.0.0 · Updated 2026-11-15 **Where:** Online Store > Themes > Customize > Theme settings > Drawers and overlays The colors of the size guide, engraving and filter drawers, how the page behind them looks, and the store-wide size guide page. ![Search opened in the header, with "Trending now" product cards under the search field](https://spellnsell.com/themes/kera/img/drawers-and-search.webp) ## Set it up 1. In **Drawers and overlays**, pick a scheme in **Product and filter drawers**. 2. Choose **Page behind drawers and menus**: **Dim**, **Blur** or **Blur and dim**, and set its color, opacity or blur. 3. Pick a **Size guide page** to use when a product has no more specific one. Search settings: [Search and predictive search](https://spellnsell.com/themes/kera/docs/collections/search). :::note The cart drawer and quick view don't use **Product and filter drawers**. They have their own **Color scheme**, in their sections in the **Overlays** group. ::: ## Settings :::details Drawers and overlays | Setting | What it does | | --- | --- | | **Product and filter drawers** | Size guide, engraving, Drop a hint and option drawers on the product page, and the filter sheet. Installs as **Scheme 1**. | | **Page behind drawers and menus** | **Dim**, **Blur** or **Blur and dim**. Installs as **Dim**. | | **Dim color** | The color laid over the page, with **Dim** or **Blur and dim**. Installs black. | | **Dim opacity** | 0% to 80%, default 45%. | | **Blur** | With **Blur** or **Blur and dim**. 2px to 24px, default 8px. | | **Size guide page** | The size guide used when a product has no more specific one. | ::: ## Good to know :::details Which size guide wins? A product's own size guide comes first, then one for its product type, then **Size guide page**. See [Size guides](https://spellnsell.com/themes/kera/docs/product-page/size-guides). ::: :::details Can my logo stay bright over the dimmed page? On larger screens, yes. Turn it on or off with **Theme settings > Logo and favicon > Show on the dimmed page**. ::: :::details The filter drawer is white on my dark store. Change **Product and filter drawers** to a darker scheme. Filters, the size guide and engraving drawers all follow it. ::: :::details Why is a drawer's top bar taller at the top of the page? The top bar of each side drawer lines up with the header's bottom line. That covers the cart, quick view, size guide, engraving, Drop a hint and option drawers. At the top of the page the line sits lower, under the announcement bar. Once the header compacts on scroll, it's higher. On phones, drawers that open as bottom sheets keep their own height. ::: :::details Can I turn off the dim behind the menu? Choose **Blur**, or keep **Dim** and set **Dim opacity** to 0%. ::: --- # Header layouts and sticky header > Choose Kera's header menu and layout, set how it sticks on scroll, and make it transparent over the first image on the home or About page. Source: https://spellnsell.com/themes/kera/docs/header-footer/header · Kera 1.0.0 · Updated 2026-11-14 **Where:** Online Store > Themes > Customize > Header > Header Your logo, the main menu, search, the account icon and the bag. Set the layout for desktop and phones, how it sticks on scroll, and whether it's transparent over the first image. ![The announcement bar above the header: logo on the left, menu in the center, and search, account and bag icons on the right](https://spellnsell.com/themes/kera/img/header.webp) ## Set it up 1. Select **Header** and pick the **Menu**. Optionally pick a **Customer account menu**. 2. Select the **Desktop** block and choose a **Layout**, **Open menu on** and a **Color scheme**. 3. Select the **Mobile** block and choose a **Layout** and a **Color scheme**. 4. Back in **Header**, choose **Sticky header**. 5. For a transparent header, turn on **Transparent on home page** or **Transparent on about page** and pick **Text and icons**. :::note The header is only transparent over a full-width first section with **Top spacing** set to **None**: **Slideshow**, **Split hero**, **Switch hero**, **Image banner**, **Dial**, or **Video feature** with **Full width** on. Over anything else it stays solid. ::: ## Settings :::details Header | Setting | What it does | | --- | --- | | **Menu** | The menu in the header and the mobile menu. Installs as **Main menu**. Up to three levels deep. | | **Customer account menu** | The menu in the account icon for signed-in customers. Empty shows Shopify's default account links. | | **Popular searches menu** | What the search panel shows before the shopper types. See [Search and predictive search](https://spellnsell.com/themes/kera/docs/collections/search). | | **Sticky header** | **Always**: stays at the top. **Always, smaller on scroll**: stays and gets shorter. **On scroll up**: slides away going down, comes back going up. **None**: scrolls away. Installs as **Always, smaller on scroll**. | | **Transparent on home page** | Transparent over a full-width first section on the home page. Installs on. | | **Transparent on about page** | The same on pages using the **about** template. Installs on. | | **Text and icons** | While transparent: **Light** for dark images, **Dark** for light images. Installs as **Light**. | ::: :::details Desktop block | Setting | What it does | | --- | --- | | **Layout** | **Logo left, menu center**, **Menu left, logo center** or **Logo center, menu below**. Applies from tablet width up. | | **Open menu on** | **Hover** or **Click**. On click, each panel ends with a link to the item's own page. | | **Color scheme** | The header's colors from tablet width up. | ::: :::details Mobile block | Setting | What it does | | --- | --- | | **Layout** | **Logo left** or **Logo center**. With the logo centered, search sits next to the menu button. | | **Color scheme** | The header's and the mobile menu's colors on phones. | Its other settings are on [Mobile menu](https://spellnsell.com/themes/kera/docs/header-footer/mobile-menu). Panels: [Mega menus](https://spellnsell.com/themes/kera/docs/header-footer/mega-menus). Every setting: [Header reference](https://spellnsell.com/themes/kera/docs/reference/sections/header). ::: ## Good to know :::details The header isn't transparent on my home page. Check that **Transparent on home page** is on, the first section is one of those listed above, and its **Top spacing** is **None**. Once the shopper scrolls or points at the header, it gets its normal background. ::: :::details How do I add a badge to a menu link? Put a label in square brackets in the link title, such as `Rings [New]`. The menu shows "Rings" with a New badge. See [Labels in square brackets](https://spellnsell.com/themes/kera/docs/store-data/labels). ::: --- # Mega menus > Style the desktop panel of a top-level menu item in Kera with columns, collection images, product previews or your own image cards. Source: https://spellnsell.com/themes/kera/docs/header-footer/mega-menus · Kera 1.0.0 · Updated 2026-11-14 **Where:** Online Store > Themes > Customize > Header > Header > Desktop > Add block > Mega menu On desktop, a top-level menu item with nested links opens a panel showing its links with images. A **Mega menu** block changes one item's panel: its layout, its images, and cards you choose. ![The Shop mega menu open: columns of links beside three image cards](https://spellnsell.com/themes/kera/img/mega-menus.webp) ## Set it up 1. In **Online Store > Navigation**, nest links under the top-level item, such as Shop > Rings, Earrings. Link to collections where you can. 2. In the editor, open **Header** > **Desktop**, click **Add block** and choose **Mega menu**, **Mega menu with cards** or **Compact mega menu**. 3. In **Menu item**, type the top-level item's name, such as `Shop`. Case, accents, punctuation and `[labels]` don't matter. 4. Choose the **Layout** and **Images**. 5. For your own cards, set **Images** to **Your cards** and add **Card** blocks inside the Mega menu block. :::note The header installs with **Mega menu** blocks for Shop and Gifts. They do nothing until your main menu has items with those names. Rename or delete them. ::: :::sidekick Open Sidekick in the theme editor and paste this, with your own names. Check the preview, then click **Save**. ```sidekick In the header's Desktop area, add a Mega menu block for the menu item "Gifts", with Layout set to Cards and Images set to Follow the pointer. ``` ::: ## Settings :::details Mega menu block | Setting | What it does | | --- | --- | | **Menu item** | The top-level main menu link this block styles, for example Shop. | | **Layout** | **Automatic**: columns when the item has third-level links, cards otherwise. **Columns**: links on the left, details and images beside them. **Cards**: one image card per link. **Compact list**: a short list with no images. Installs as **Automatic**. | | **Images** | **Follow the pointer**: images of the link the shopper points at, up to 3, or a collection's image plus its products. **Your cards**: your **Card** blocks. **No images**: links only. Hidden for **Compact list**. | | **Products next to a collection** | With **Follow the pointer**: 0 to 3 products beside a collection's image. Default 2. | | **Card shape** | With **Your cards**: **Portrait**, **Square** or **Landscape**. | | **Cards position** | With **Your cards** and columns: **Right** or **Left** of the columns. | ::: :::details Card block | Setting | What it does | | --- | --- | | **Collection** | Shows the collection's image and name, and links to it. The collection's real size metafield shows on hover. | | **Product** | Shows the product's image, name and price, and links to it. | | **Image** | Your own image. Replaces the collection or product image. | | **Heading** | Replaces the collection or product name. | | **Caption** | A short line under the heading, such as Up to 30% off. Product cards show their price when this is empty. | | **Link** | Replaces the collection or product link. | ::: ## Good to know :::details How do menu levels become a panel? The top level (Shop) opens the panel; the second level (Rings) is its links. When any second-level link has links of its own (Gold rings), the panel shows columns: the first lists the second-level links, and pointing at one shows its links beside it. With **Your cards** or **No images**, a collection link without links of its own lists up to 5 of its products and an "All" link. ::: :::details My Mega menu block doesn't change anything. **Menu item** doesn't match a top-level link in the header's **Menu**. In the editor preview on desktop, a note above the panels lists the names you can use. The note never shows on the store. When two blocks name the same item, the lower one in the sidebar wins. ::: :::details Can an item without nested links open a panel? Yes. Add a **Mega menu** block for it, such as Gifts linking to a page, set **Images** to **Your cards**, and add **Card** blocks. On phones, the item stays a plain link. ::: --- # Mobile menu > Set up Kera's phone menu as an accordion or tabs, show collection images or your own cards per item, and add a promo card. Source: https://spellnsell.com/themes/kera/docs/header-footer/mobile-menu · Kera 1.0.0 · Updated 2026-11-14 **Where:** Online Store > Themes > Customize > Header > Header > Mobile On phones, the menu button opens a full-screen menu built from the same **Menu** as desktop. The **Mobile** block sets how items open and what sits at the bottom; **Mobile menu** blocks change how one item looks. ![The phone menu drawer: top-level links with arrows, a promo card, social icons and Log in](https://spellnsell.com/themes/kera/img/mobile-menu.webp) ## Set it up 1. Open **Header** and select **Mobile**. The preview opens the mobile menu. 2. Choose a **Menu layout**: **Accordion** or **Tabs**. 3. Set the promo card's **Image**, **Badge**, **Heading** and **Link**, or clear **Heading** and **Image** to remove it. 4. To change one item, click **Add block**, choose **Mobile menu** or **Mobile menu with cards**, and type the top-level item's name in **Menu item**, such as `Shop`. 5. Choose **Images**. For **Your image cards**, add **Card** blocks inside it. :::warning The promo card installs with sample **Badge** and **Heading** text, so it shows on phones from the start. Replace the text or clear it. ::: ## Settings :::details Mobile block | Setting | What it does | | --- | --- | | **Menu layout** | **Accordion**: items stack in one list and open right under themselves, all starting closed. **Tabs**: items with links sit in a tab row and one shows at a time, starting with the first; items without links are plain links in the row. Installs as **Accordion**. | | **Show social media icons** | Icons at the bottom, from **Theme settings > Social media**. Installs on. | | **Show country and language** | Selectors at the bottom, when the store sells in more than one country or language. Installs on. | | **Image** | The promo card's image. | | **Badge** | A short line on the promo card, such as Up to 20% off. | | **Heading** | The promo card's heading. | | **Link** | Where the promo card goes. Empty links to the home page. | | **Card color scheme** | The promo card's colors. The same scheme as the menu shows the card without a box. | **Layout** and **Color scheme** are on [Header layouts and sticky header](https://spellnsell.com/themes/kera/docs/header-footer/header). ::: :::details Mobile menu block | Setting | What it does | | --- | --- | | **Menu item** | A top-level main menu link with nested links, for example Shop. Case, accents, punctuation and `[labels]` don't matter. | | **Images** | **Collection images**: each link as a card with its collection's image. **Your image cards**: your **Card** blocks. **None**: a plain list of links. Installs as **Collection images**. | | **Card shape** | With **Your image cards**: **Portrait**, **Square** or **Landscape**. | | **Cards heading** | With **Your image cards**, on an item with groups: the heading above the cards. Default "Featured". | | **Cards layout** | With **Your image cards**, on an item with groups: **Carousel** or **Grid**. | **Card** blocks have the same settings as in a mega menu: **Collection**, **Product**, **Image**, **Heading**, **Caption** and **Link**. See [Mega menus](https://spellnsell.com/themes/kera/docs/header-footer/mega-menus). ::: ## Good to know :::details How is the menu built from my links? Each top-level link is an item; links nested under it are what it opens to. Links one level deeper form a group that opens and closes, and each item's first group starts open. An item without nested links is a plain link. With **Collection images**, an item whose links have no links of their own shows them as image cards with each collection's image. With **Your image cards**, an item without groups shows your cards instead of its links; an item with groups keeps them and shows the cards underneath. ::: :::details What's at the bottom of the menu? The promo card (when it has a **Heading** or **Image**), social icons, **Log in** or **Account** when customer accounts are on, and the country and language selectors. ::: :::details My Mobile menu block does nothing. **Menu item** matches no item with nested links. The editor shows a note listing the names you can use; it never shows on the store. The header installs with a block set to Shop with three empty cards, which do nothing until your menu has a Shop item with nested links. ::: --- # Announcement bar > Show short messages or a countdown above Kera's header, as a scrolling ticker, one message at a time, or all at once. Source: https://spellnsell.com/themes/kera/docs/header-footer/announcement-bar · Kera 1.0.0 · Updated 2026-11-15 **Where:** Online Store > Themes > Customize > Header > Announcement bar The thin band above the header. It shows up to 6 messages, such as a delivery note or a link to a new collection, and can count down to the end of a sale. ![The red announcement bar with three messages above the header](https://spellnsell.com/themes/kera/img/announcement-bar.webp) ## Set it up 1. Open **Announcement bar** and choose a **Layout**: **Scrolling ticker**, **One message at a time** or **All messages at once**. 2. Select each of the three sample **Message** blocks and change its **Text**. Add a **Link** and an **Icon** if you want. 3. To add a message, click **Add block** > **Message**. 4. For a countdown, click **Add block** > **Countdown** and enter **End date** (YYYY-MM-DD) and **End time** (24-hour, such as 18:00). :::note The countdown ends at the same moment for every visitor, in your store's time zone. An invalid date shows a note in the editor and nothing on the store. ::: :::sidekick Open Sidekick in the theme editor and paste this, with your own names. Check the preview, then click **Save**. ```sidekick In the announcement bar, set the messages to "Free shipping over €150", "Engraving on every piece" and "30-day returns", use the layout One message at a time, and add a Countdown block ending 2027-02-14 at 18:00. ``` ::: ## Settings :::details Announcement bar | Setting | What it does | | --- | --- | | **Color scheme** | The bar's colors. Installs as **Scheme 4**. | | **Layout** | **Scrolling ticker**: messages loop across the bar. **One message at a time**: they change in turn. **All messages at once**: side by side, not moving. Installs as **Scrolling ticker**. | | **Scroll speed** | Ticker only: 20 to 80 seconds per loop, default 40. Higher is slower. | | **Time per message** | One at a time only: 3 to 10 seconds, default 5. Pauses while a visitor hovers over or focuses the bar. | | **Show pause button** | Adds a pause button. The bar also pauses on hover and focus. Installs on. | | **Transition** | One at a time only: **Slide up**, **Slide sideways** or **Fade**. | | **Show arrows** | One at a time only: arrows to move between messages. | | **Between messages** | Ticker and all at once: **Diamond**, **Star**, **Dot**, **Line**, **Slash** or **Nothing**. | | **Arrow after linked messages** | Adds an arrow after messages that have a link. Installs off. | ::: :::details Message block | Setting | What it does | | --- | --- | | **Text** | The message. | | **Link** | Makes the message a link. | | **Icon** | An icon before the message, such as **Shipping**, **Returns**, **Gift** or **Discount**. Installs as **None**. | | **Use its own colors** | Gives this message its own colored band. | | **Color scheme** | The band's colors when **Use its own colors** is on. | ::: :::details Countdown block | Setting | What it does | | --- | --- | | **Text before the timer** | Text before the time left, such as "Sale ends in". | | **Text after the timer** | Text after the time left. | | **Link** | Makes the countdown a link. | | **Icon** | An icon before the countdown. | | **End date** | YYYY-MM-DD, for example 2026-12-31. | | **End time** | HH:MM, 24-hour clock. Empty means 00:00. | | **When finished** | Shown once the countdown ends. Empty removes it from the bar. | | **Style** | How the time shows: 2d 14h 36m, or 2d 14:36. | | **Show seconds** | Adds seconds to the timer. Installs on. | | **Use its own colors** | Gives the countdown its own colored band. | ::: Every setting: [Announcement bar reference](https://spellnsell.com/themes/kera/docs/reference/sections/announcement-bar). ## Good to know :::details How do I stop the bar from moving? Set **Layout** to **All messages at once**. Visitors with reduced motion turned on always see the messages standing still, centered in short rows without separators. **One message at a time** with a single message also stands still. ::: :::details I turned off the pause button, but keyboard users still see it. That is on purpose. With **Show pause button** off, the button still appears when it gets keyboard focus, so everyone can stop moving content. ::: --- # Footer > Set up Kera's footer with newsletter, menu and text columns, selectors, social and payment icons, policy links and the large wordmark. Source: https://spellnsell.com/themes/kera/docs/header-footer/footer · Kera 1.0.0 · Updated 2026-11-14 **Where:** Online Store > Themes > Customize > Footer > Footer Up to 6 columns (newsletter sign-up, menus and text), a bottom row with selectors, social, policy and payment icons, and an optional large wordmark of your store name. ![The dark footer: newsletter sign-up, link columns, payment icons and a large wordmark](https://spellnsell.com/themes/kera/img/footer.webp) ## Set it up 1. Open **Footer** and select each installed block (**Newsletter**, **Menu**, **Text**) to change its **Heading** and content. 2. Set each block's **Width on desktop**. Blocks wrap to a new row when the row is full. 3. To add a column, click **Add block** and choose **Newsletter**, **Menu** or **Text**. Drag blocks to reorder. 4. Select **Footer** and turn off any bottom-row parts you don't want. 5. Review the **Icons with text** section above the footer: it installs with three sample promises. :::note The **Menu** block shows the top-level links of its menu only. Nested links are not shown. ::: ## Settings :::details Footer All install on. | Setting | What it does | | --- | --- | | **Color scheme** | The footer's colors. Installs as **Scheme 3**. | | **Show country selector** | Only when the store sells in more than one country. Add markets in **Settings > Markets**. | | **Show language selector** | Only with more than one language. Add languages in **Settings > Languages**. | | **Show social media icons** | One icon per link filled in under **Theme settings > Social media**. | | **Show payment icons** | The payment methods turned on for your store. | | **Show policy links** | Links to each policy with content in **Settings > Policies**. | | **Show Follow on Shop** | The Follow on Shop button, when Shopify offers it for your store. | | **Show large wordmark** | The store name in large letters across the bottom. | | **Wordmark text** | Replaces the store name in the wordmark. | | **Reveal wordmark on scroll** | The wordmark rises into view at the bottom of the page. Visitors with reduced motion see it in place. | ::: :::details Blocks | Setting | What it does | | --- | --- | | **Heading** | The small heading at the top of the block. | | **Text** | In **Newsletter**: the line above the email field. In **Text**: the block's text, with formatting. | | **Menu** | In **Menu**: the menu to list. Installs as **Footer menu**. | | **Width on desktop** | **1/6**, **1/4**, **1/3**, **1/2**, **2/3**, **3/4** or **Full width**. | ::: ## Good to know :::details Who does the Newsletter block sign up? Visitors become customers tagged `newsletter`. For a newsletter band or popup elsewhere, see [Newsletter, popup and reviews](https://spellnsell.com/themes/kera/docs/sections/newsletter-and-reviews). ::: :::details What is Icons with text? A section in the **Footer** group, above the footer, with short promises such as delivery or returns on every page. Up to 6 items. Replace the three sample items or remove the section. ::: :::details Does the password page use this footer? No. It has its own **Footer** in the **Password page footer** group. Edit it from the password template. ::: --- # Heroes and slideshows > Add a large opening section to a page, from a slideshow to a shoppable image banner, and set each one up in a few steps. Source: https://spellnsell.com/themes/kera/docs/sections/heroes · Kera 1.0.0 · Updated 2026-11-14 **Where:** Online Store > Themes > Customize > Add section Six sections made to open a page. Dial and Text reveal are under **Storytelling** in the section list; the rest are under **Banners**. | Section | What it's for | | --- | --- | | [Slideshow](#slideshow) | Up to 3 full-width slides that change on their own | | [Split hero](#split-hero) | Two or three categories side by side, each a link | | [Switch hero](#switch-hero) | One piece in up to 4 views, such as still and worn | | [Image banner](#image-banner) | A campaign image with dots that open product cards | | [Dial](#dial) | Zodiac signs, seasons, birthstones or weekdays, starting on today's | | [Text reveal](#text-reveal) | A short brand statement that fills in as shoppers scroll | New to the editor? See [How the editor is organized](https://spellnsell.com/themes/kera/docs/get-started/editor-basics). For a single video, see [Video sections](https://spellnsell.com/themes/kera/docs/sections/video). :::sidekick Open Sidekick in the theme editor and paste this, with your own names. Check the preview, then click **Save**. ```sidekick Add an Image banner section to the home page under the Slideshow. Set the Heading to "The winter edit" and add Hotspot blocks for the products "Pearl drop earrings" and "Chain bracelet". ``` ::: ## Slideshow ![A full-screen slideshow with the heading "Gold for every day" and slide tabs along the bottom](https://spellnsell.com/themes/kera/img/heroes.webp) Full-width image or video slides that change on their own or from a row of tabs. 1. Add a **Slideshow** section. It starts with 3 **Image slide** blocks. 2. In each slide, choose an **Image** and set the **Button label** and **Button link**. 3. Choose a **Text color** that reads on the image. 4. For a video, click **Add block** > **Video slide**. Up to 3 slides in all. :::details Slideshow settings | Setting | What it does | | --- | --- | | **Change slides automatically** | Slides move on after **Seconds per slide**, 3 to 10. | | **Mobile image** | On a slide: a portrait crop for phones. | | **Text color** | On a slide: **Light, for dark images** or **Dark, for light images**. | | **Slide tab heading** | On a slide: its name in the tab row. Empty shows "1 of 3" and so on. | | **Poster image** | On a video slide: shows until the video plays. | The tab row shows with 2 or more slides. A slide without an image shows a placeholder. Every setting: [Slideshow reference](https://spellnsell.com/themes/kera/docs/reference/sections/hero-slider) ::: ## Split hero Two or three panels side by side, each with an image or video, a heading and a link. 1. Add a **Split hero** section. It starts with a **Video** panel and an **Image** panel. 2. In each panel, choose a **Video** or an **Image**. 3. Set the **Link label** and **Link**. The whole panel links there. 4. For a third panel, click **Add block** > **Image** or **Video**. :::details Split hero settings | Setting | What it does | | --- | --- | | **Layout on mobile** | **Stacked** or **Side by side**. | | **Mobile image** | On a panel: a crop for phones. Video panels have **Mobile video**. | | **Focus** | On a panel: the part of a wide image kept in view: **Focal point**, **Left** or **Right**. | | **Text color on phones** | On an image panel: for a phone image lighter or darker than the main one. | Videos play muted on a loop. Visitors who prefer reduced motion see the preview image. Every setting: [Split hero reference](https://spellnsell.com/themes/kera/docs/reference/sections/split-hero) ::: ## Switch hero One product in up to 4 views, such as still and worn. Shoppers switch views with a toggle, the arrow keys or a swipe. 1. Add a **Switch hero** section. It starts with two **View** blocks. 2. Choose a **Product**. Views without their own image use its images in order. 3. In each view, set the **Toggle label** and choose **Text on this photo**: **Light** or **Dark**. 4. Set the **Button label** and **Second link label**. :::details Switch hero settings | Setting | What it does | | --- | --- | | **Product** | Supplies images to views without one, and is where the button and second link go when theirs is empty. | | **Show caption** | A caption with the piece's name, option and price. | | **Caption heading** | Empty uses the product name. Each view can set its own. | | **Mobile image** | On a view: shown on phones instead. | A view with no image and no product image shows a placeholder. Every setting: [Switch hero reference](https://spellnsell.com/themes/kera/docs/reference/sections/switch-hero) ::: ## Image banner One large image with text, two links and up to 6 hotspots: dots that open a small product card. 1. Add an **Image banner** section. It starts with two **Hotspot** blocks. 2. Choose an **Image**, then set the link labels and links. 3. In each hotspot, choose a **Product**. Move the dot onto the piece with **Horizontal position** and **Vertical position**, 0 to 100%. 4. For more pieces, click **Add block** > **Hotspot**. :::note A link shows only with both a label and a link. The default labels show nothing until you add the links. ::: :::details Image banner settings | Setting | What it does | | --- | --- | | **Pin behind the next section** | The next section slides over the banner as the page scrolls, on tablets and desktop. | | **Text on mobile** | **On the image**, or **Below the image** to show the whole image uncropped. | | **Mobile crop** | The part of a wide image kept in view on phones. | | **Show the card at first** | On a hotspot: opens its card when the page loads. Only the first one with this on opens. | | **Set a different position on mobile** | On a hotspot: a second position for phones, for a **Mobile image** or a crop that moves the piece. | Every setting: [Image banner reference](https://spellnsell.com/themes/kera/docs/reference/sections/campaign-banner) ::: ## Dial ![The Dial section: a zodiac constellation charm above a curved scale of sign names](https://spellnsell.com/themes/kera/img/dial.webp) A full-screen photo per item, with the items on an arc below, for anything in a cycle. 1. Add **Dial: zodiac**, **Dial: seasons**, **Dial: birthstones** or **Dial: days of the week**. Each comes with its items and dates. 2. In each **Item**, choose an **Image** and set the **Link label** and **Link**. 3. For your own cycle, click **Add block** > **Item** and set the **Name** and dates or **Weekday**. Up to 24. 4. Choose what the dial should **Start on**. :::details Dial settings | Setting | What it does | | --- | --- | | **Start on** | **Today's item** or **A chosen item**. With no match for today, it starts on the chosen item. | | **Today's item is the one whose** | **Dates include today** or **Weekday is today**, on the visitor's own date. | | **Spacing between items** | 10 to 45°. | | **Photo overlay** | 0 to 60%. Darkens the photo. | | **Turn on its own** | Moves on after **Time on each item**, 3 to 12 seconds. | Shoppers turn the dial by tapping a name, dragging, swiping or with the arrow keys. Every setting: [Dial reference](https://spellnsell.com/themes/kera/docs/reference/sections/dial) ::: ## Text reveal A short statement whose words fill in as the shopper scrolls. It works well right after an image hero. 1. Add a **Text reveal** section. 2. Write a sentence or two in **Text**. 3. Optional: set a **Link label** and **Link**, such as to your about page. :::details Text reveal settings | Setting | What it does | | --- | --- | | **Text size** | **Large**, **Medium** or **Small**. | | **Reveal start point** | Where on the screen the reveal begins: 50 to 100%. | | **Finish revealing at** | Where it ends: 20 to 60%. | Visitors who prefer reduced motion see all the text at once. Every setting: [Text reveal reference](https://spellnsell.com/themes/kera/docs/reference/sections/intro-reveal) ::: ## Good to know :::details How do I put the header over the hero? In the **Header** section, turn on **Transparent on home page** or **Transparent on about page**, and choose **Light** or **Dark** for **Text and icons**. The first section must be a Slideshow, Split hero, Switch hero, Image banner or Dial, or a Video feature with **Full width** on, with **Top spacing** set to **None**. See [Header layouts and sticky header](https://spellnsell.com/themes/kera/docs/header-footer/header). ::: --- # Collection and product sections > Add sections that lead shoppers to your collections and products, and set each one up in a few steps. Source: https://spellnsell.com/themes/kera/docs/sections/collections-and-products · Kera 1.0.0 · Updated 2026-11-15 **Where:** Online Store > Themes > Customize > Add section Nine sections show your collections or products on any page. Their product cards follow [Product cards and badges](https://spellnsell.com/themes/kera/docs/theme-settings/product-cards). | Section | What it's for | | --- | --- | | [Collection tiles](#collection-tiles) | A compact row of category shortcuts | | [Collection list](#collection-list) | Large image cards for your main categories | | [Collection links](#collection-links) | A typographic list of categories with a hover preview | | [Collection showcase](#collection-showcase) | Up to 6 collections, told one at a time beside a large image | | [Collection tabs](#collection-tabs) | New arrivals or bestsellers split into rings, earrings and more | | [Featured collection](#featured-collection) | One collection's products in a grid | | [Product tiles](#product-tiles) | The same grid with heading alignment, starting at 2 rows | | [Featured product](#featured-product) | One product with a buy form, on any page | | [Shop by material](#shop-by-material) | A card per material, such as a metal, linking to its collection | New to the editor? See [How the editor is organized](https://spellnsell.com/themes/kera/docs/get-started/editor-basics). :::sidekick Open Sidekick in the theme editor and paste this, with your own names. Check the preview, then click **Save**. ```sidekick Add a Collection tabs section to the home page under the first section, with three Tab blocks for the collections "Rings", "Earrings" and "Necklaces". Set Products per tab to 8. ``` ::: ## Collection tiles ![A row of round tiles, each with a gold piece on a soft gray background and a collection name under it, such as Earrings, Rings and Pearls](https://spellnsell.com/themes/kera/img/collection-tiles.webp) A row of small tiles, one per collection, for category shortcuts near the top of a page. 1. Add a **Collection tiles** section. It starts with 8 **Tile** blocks. 2. In each tile, choose a **Collection**. Click **Add block** > **Tile** for more, up to 16. 3. Choose a **Shape** and how the **Image** fits the tile. :::details Collection tiles settings | Setting | What it does | | --- | --- | | **Tiles per row on desktop** | 4 to 10. More tiles scroll with arrows. | | **Tiles in view on phones** | **2.5**, **3.5** or **4.5**. The cut-off tile shows shoppers they can swipe. | | **Image** | **Fit with space** for cut-outs on a plain background, **Fill the tile** for photos. | | **Tile background** | The color behind each image. Transparent uses the color scheme. | | **Label** | On a tile: replaces the collection title. | A tile without a collection shows a placeholder. Every setting: [Collection tiles reference](https://spellnsell.com/themes/kera/docs/reference/sections/collection-tiles) ::: ## Collection list ![Four tall image cards, Earrings, Necklaces, Rings and Bracelets, under the heading "Shop by category" with an All collections link](https://spellnsell.com/themes/kera/img/collection-list.webp) Image cards with each collection's name, plus a link to all collections. 1. Add a **Collection list** section. With no blocks, it shows your store's collections. 2. To choose the collections and their order, click **Add block** > **Collection**. Up to 12. 3. Set **Columns on desktop** and **Image ratio**. :::details Collection list settings | Setting | What it does | | --- | --- | | **Rows** | 1 to 3. How many collections show without blocks: rows × columns. | | **Columns on mobile** | **1** or **2**. With 2, a last card that would sit alone is left out. | | **Link label** | The link to all collections. Empty hides it. | | **Image** | On a block: replaces the collection image. | Set each collection's image in **Products > Collections** so the cards work without blocks. Every setting: [Collection list reference](https://spellnsell.com/themes/kera/docs/reference/sections/collection-list) ::: ## Collection links ![A list of large category names, Earrings, Necklaces, Rings, Bracelets and Pearls, each with a small product count](https://spellnsell.com/themes/kera/img/collections-and-products.webp) A list of collection names in large type, each with its product count and starting price. On desktop, hovering a name shows a preview image. 1. Add a **Collection links** section. It starts with 4 **Collection** blocks. 2. In each block, choose a **Collection**. Up to 8. 3. Optional: set a **Preview image** to replace the collection image. :::details Collection links settings | Setting | What it does | | --- | --- | | **Show numbers** | Numbers each row: 01, 02, 03. Off by default. | | **Show product count** | A small number at the top right of each name. | | **Show starting price** | **From** and the lowest price in the collection, at the end of the row. | | **Show arrow** | An arrow at the end of each row, on desktop. | | **Hint** | A short line inviting shoppers to hover. | | **Titles and preview image** | **Image over titles**, **Titles over image**, or **Titles over image, inverted** for a white or black background. | | **Preview image** | On a block: the image shown on hover. | Phones and tablets show no preview. Every setting: [Collection links reference](https://spellnsell.com/themes/kera/docs/reference/sections/category-index) ::: ## Collection showcase ![A large photo of gold earrings, a signet ring and a chain bracelet beside a list: 01 Everyday gold, 02 The Statement, each with a short text and a Shop the collection link](https://spellnsell.com/themes/kera/img/collection-showcase.webp) A large image stays in place while a numbered list of collections scrolls beside it. 1. Add a **Collection showcase** section. It starts with 3 **Collection** blocks. 2. In each block, choose a **Collection**. Up to 6. 3. Check each block's **Text** and **Image**. Empty fields use the collection's description and image. :::details Collection showcase settings | Setting | What it does | | --- | --- | | **Text** | On a block: replaces the collection description. Keep it to a sentence or two. | | **Image** | On a block: replaces the collection image. Portrait images of one shape work best. | | **Link label** | On a block: the link to the collection. | On phones and tablets, each collection shows its own image above its text. Every setting: [Collection showcase reference](https://spellnsell.com/themes/kera/docs/reference/sections/collections-split) ::: ## Collection tabs ![The heading New this season with tabs for Rings, Earrings and Necklaces, and a row of four rings with New badges](https://spellnsell.com/themes/kera/img/collection-tabs.webp) One tab per collection, each with a row of product cards shoppers can swipe. 1. Add a **Collection tabs** section. It starts with 2 **Tab** blocks. 2. In each tab, choose a **Collection**. Up to 4 tabs. 3. Set **Products per tab**. :::details Collection tabs settings | Setting | What it does | | --- | --- | | **Products per tab** | **4**, **8** or **12**, in the collection's sort order. | | **Show link to the collection** | A link under the row to the open tab's collection. | | **Tab heading** | On a tab: replaces the collection title. | To change the order of products, sort the collection in **Products > Collections**. Every setting: [Collection tabs reference](https://spellnsell.com/themes/kera/docs/reference/sections/new-in-tabs) ::: ## Featured collection ![A grid of eight product cards under the heading "Worn every day", with badges such as Bestseller, Sale and New](https://spellnsell.com/themes/kera/img/product-cards.webp) A grid of product cards from one collection, with a link to it. 1. Add a **Featured collection** section. 2. Choose a **Collection**. 3. Set **Rows**, **Columns on desktop** and **Columns on mobile**. :::details Featured collection settings | Setting | What it does | | --- | --- | | **Rows** | 1 to 4. | | **Columns on mobile** | **1** or **2**. With 2, a last product that would sit alone is left out. | | **Full bleed** | Runs the grid edge to edge. With the **Framed** card style, cards share their hairlines. | | **Link label** | The link to the collection. Shown when a collection is chosen. | Every setting: [Featured collection reference](https://spellnsell.com/themes/kera/docs/reference/sections/featured-collection) ::: ## Product tiles ![The heading Just in from the atelier with a Shop new in link and four product cards with New badges](https://spellnsell.com/themes/kera/img/product-tiles.webp) The same grid as Featured collection, with **Heading alignment** and 2 rows to start. 1. Add a **Product tiles** section. 2. Choose a **Collection**. 3. Set **Heading alignment**, **Rows** and the columns. :::details Product tiles settings | Setting | What it does | | --- | --- | | **Heading alignment** | **Left**, **Center** or **Right**. | | **Rows** | 1 to 4. | | **Columns on mobile** | **1** or **2**. With 2, a last product that would sit alone is left out. | | **Link label** | The link to the collection. | Every setting: [Product tiles reference](https://spellnsell.com/themes/kera/docs/reference/sections/product-tiles) ::: ## Featured product One product with its photos and a buy form. Choosing a variant updates the price, photos and button. 1. Add a **Featured product** section. 2. Choose a **Product**. 3. Hide the blocks you don't need with the eye icon, and drag the rest to change their order. :::details Featured product settings | Setting | What it does | | --- | --- | | **Media position on desktop** | **Left** or **Right**. | | **Style** | Variant picker block: **Buttons**, **Color circles**, **Variant images**, **Variant tiles**, **Squares** or **Dropdown**. | | **Show quantity selector** | Buy buttons block. | | **Text under the button** | Buy buttons block: a short line, such as a delivery promise. | The photo gallery uses the product page's settings: see [Media gallery and full-screen viewer](https://spellnsell.com/themes/kera/docs/product-page/media-gallery). Every setting: [Featured product reference](https://spellnsell.com/themes/kera/docs/reference/sections/featured-product) ::: ## Shop by material ![A gray band with the heading Choose your tone and three metals, Yellow gold, Sterling silver and Rose gold, each with a color swatch and a piece count](https://spellnsell.com/themes/kera/img/shop-by-metal.webp) A card per material, such as each metal you sell, with a color swatch and a piece count, each linking to that material's collection. 1. In **Products > Collections**, create a collection per material, such as an automated one with "Variant's title contains Yellow gold". 2. Add a **Shop by material** section. It starts with 4 **Material** blocks. 3. In each block, choose the material's **Collection**. Up to 6. 4. Check each **Name**: the swatch takes the color of the metal or material it names. :::details Shop by material settings | Setting | What it does | | --- | --- | | **Show number of pieces** | Counts the products in each material's collection. | | **Layout on mobile** | **Carousel** swipes sideways. **Grid** shows two across. | | **Name** | On a block: empty uses the collection title. | | **Swatch color** | On a block: empty uses the theme's color for the material in **Name**. | Every setting: [Shop by material reference](https://spellnsell.com/themes/kera/docs/reference/sections/shop-by-metal) ::: --- # Editorial sections > Add text, image and story sections for About pages, brand stories and promotions, and set each one up in a few steps. Source: https://spellnsell.com/themes/kera/docs/sections/editorial · Kera 1.0.0 · Updated 2026-11-14 **Where:** Online Store > Themes > Customize > Add section Sections that tell your story around the products: who you are, how pieces are made, and what's on now. Customer quotes are in [Newsletter, popup and reviews](https://spellnsell.com/themes/kera/docs/sections/newsletter-and-reviews). | Section | What it's for | | --- | --- | | [Rich text](#rich-text) | A short band of text with a button, such as an intro | | [Image with text](#image-with-text) | An image beside text, facts or feature icons | | [Marquee](#marquee) | A line of short phrases that scrolls across the page | | [Quote with image](#quote-with-image) | A founder's quote beside a photo | | [Logo list](#logo-list) | Press or partner logos | | [Stats](#stats) | Large figures, such as the year you started | | [Timeline](#timeline) | Your brand's story, year by year | | [Process index](#process-index) | How your pieces are made, step by step | | [Portrait grid](#portrait-grid) | Photos of your makers or of pieces worn | | [Services](#services) | Services such as gift wrapping, repairs or shipping | | [FAQ](#faq) | Questions that open in place | | [Call to action band](#call-to-action-band) | A short message with a link and a button | | [Countdown](#countdown) | A countdown to the end of a sale or a launch | | [Icons with text](#icons-with-text) | Short promises, such as delivery and returns | New to the editor? See [How the editor is organized](https://spellnsell.com/themes/kera/docs/get-started/editor-basics). New sections start with sample text, and shoppers see it, so replace it before you publish. :::sidekick Open Sidekick in the theme editor and paste this, with your own words. Check the preview, then click **Save**. ```sidekick In the Stats section on the about page, set the four Figure blocks to "2016" Year founded, "12" Makers, "100%" Recycled gold, "4" Studios. ``` ::: ## Rich text A text band built from **Eyebrow**, **Heading**, **Text** and **Button** blocks, in any order. 1. Add a **Rich text** section. It starts with one block of each kind. 2. Replace each block's text. Hide the ones you don't need with the eye icon. 3. In the **Button** block, set a **Label** and a **Link**. 4. Choose an **Alignment**. :::details Rich text settings | Setting | What it does | | --- | --- | | **Alignment** | **Left**, **Center**, or **Text left, button right**. | | **Size** | Heading and Text blocks: the text size. | | **Style** | Button block: **Primary**, **Secondary**, **Text link** or **Line**. | A button shows only with both a **Label** and a **Link**. Can also go in the footer group. Every setting: [Rich text reference](https://spellnsell.com/themes/kera/docs/reference/sections/rich-text) ::: ## Image with text An image on one side and text blocks on the other, for your materials, process or team. 1. Add an **Image with text** section. 2. Choose an **Image**, and set the **Image ratio** and **Image position on desktop**. 3. Replace the text blocks' text, and hide the ones you don't need. 4. Optional: click **Add block** > **Facts** or **Features** for key figures or feature icons. :::details Image with text settings | Setting | What it does | | --- | --- | | **Image to the edge of the screen** | Runs the image to the edge of the screen. | | **Muted color** | Text block: shows the text in a softer color. | | **Label 1** | Facts block: up to 3 facts, each a label and a value. A fact shows only with both. | | **Icon** | Feature block: an icon in a thin ring. | On phones, the image sits above the text. Fill in or hide the sample facts and features. Every setting: [Image with text reference](https://spellnsell.com/themes/kera/docs/reference/sections/image-with-text) ::: ## Marquee A line of up to 8 short phrases that scrolls across the page, each with an optional icon. 1. Add a **Marquee** section. It starts with four **Item** blocks. 2. In each item, replace the **Text**. Optional: choose an **Icon**. 3. For more, click **Add block** > **Item**. :::details Marquee settings | Setting | What it does | | --- | --- | | **Text size** | **Body large**, **Heading 4** or **Heading 3**. | | **Seconds per loop** | 20 to 120. Higher is slower. | It pauses when pointed at and has a pause button. Can also go in the footer group. Every setting: [Marquee reference](https://spellnsell.com/themes/kera/docs/reference/sections/marquee) ::: ## Quote with image A founder's quote with a name, a role, an optional link and a captioned photo. 1. Add a **Quote with image** section. 2. Replace the **Quote**, **Name** and **Role**. 3. Choose an **Image** and write a **Caption**, or clear it. :::details Quote with image settings | Setting | What it does | | --- | --- | | **Intro line** | A short line under the eyebrow. | | **Quote** | Type the quotation marks yourself. | | **Quote size** | **Large**, **Medium** or **Small**. | | **Link label** | The link shows only with both a label and a **Link**. | | **Image position on desktop** | **Right** or **Left**. | The sample "Name", "Role" and "Add a caption" show to shoppers until you replace them. Every setting: [Quote with image reference](https://spellnsell.com/themes/kera/docs/reference/sections/quote-with-image) ::: ## Logo list Up to 16 press or partner logos in a slow loop or a still row. 1. Add a **Logo list** section. It starts with six **Logo** blocks. 2. In each block, choose a **Logo image** and type the **Brand name**. 3. Remove the logos you don't need, and choose a **Layout**. :::details Logo list settings | Setting | What it does | | --- | --- | | **Layout** | **Marquee** scrolls the logos. **Static row** keeps them still. | | **Seconds per loop** | Marquee: 10 to 120. Higher is slower. | | **Logo height** | 16 to 80 pixels. | | **Show logos in one gray tone** | Logos show in full color on hover. | | **Logo image** | On a block: a .png or .svg with a transparent background works best. | A logo with no image and no brand name shows a placeholder. Can also go in the footer group. Every setting: [Logo list reference](https://spellnsell.com/themes/kera/docs/reference/sections/logo-list) ::: ## Stats Up to 8 large figures, each with a label, such as "2016, Year founded". 1. Add a **Stats** section. It starts with four **Figure** blocks. 2. In each block, replace the **Figure** and **Label**. 3. For more, click **Add block** > **Figure**. :::details Stats settings | Setting | What it does | | --- | --- | | **Columns on desktop** | 2 to 4. | | **Columns on mobile** | **1** or **2**. | | **Figure** | On a block: a year, number or short value, like 2016 or 100%. Keep it short. | Every setting: [Stats reference](https://spellnsell.com/themes/kera/docs/reference/sections/stats) ::: ## Timeline ![A timeline with the years 2016, 2018, 2021, 2024 and Today, and a photo and caption under the first year](/themes/kera/img/editorial.webp "Timeline") Up to 8 years on a line. Pointing at or tapping a year opens its heading, text and photo. 1. Add a **Timeline** section. It starts with five **Year** blocks. 2. In each block, replace the **Year**, **Heading** and **Text**, and choose an **Image**. 3. For more, click **Add block** > **Year**. Drag the years into order. :::details Timeline settings | Setting | What it does | | --- | --- | | **Hint** | Shown on the right on desktop, such as "Hover a year". | | **Year** | On a block: a year or a short label, like Today. | | **Image** | On a block: landscape, 5:4. Empty shows no photo. | On phones, the years scroll sideways and the year a swipe stops on opens. Every setting: [Timeline reference](https://spellnsell.com/themes/kera/docs/reference/sections/timeline) ::: ## Process index Up to 8 numbered steps, each with a heading, text, photo and optional link. 1. Add a **Process index** section. It starts with four **Step** blocks. 2. In each block, replace the **Heading** and **Text**, and choose an **Image**. 3. For more, click **Add block** > **Step**. Drag the steps into order. :::details Process index settings | Setting | What it does | | --- | --- | | **Text** | An intro line beside the steps. | | **Show line above** | A thin line above the section's content. | | **Image** | On a step: portrait, 4:5. | | **Link** | On a step: the whole row links there and shows an arrow. | On desktop, pointing at a step shows its text and photo beside the list. On phones, every step shows them. Every setting: [Process index reference](https://spellnsell.com/themes/kera/docs/reference/sections/process-index) ::: ## Portrait grid Up to 12 captioned photos in a grid, for your makers or for pieces worn. 1. Add a **Portrait grid** section. It starts with four **Photo** blocks. 2. In each block, choose an **Image** and write a **Caption**. 3. For more, click **Add block** > **Photo**. 4. Set the columns and **Mobile layout**. :::details Portrait grid settings | Setting | What it does | | --- | --- | | **Columns on desktop** | 2 to 5. | | **Mobile layout** | **Grid**, or **Carousel**: one row that swipes sideways. | | **Image ratio** | **Portrait**, **Tall** or **Square**. Photos are cropped to it. | | **Black and white photos** | Photos turn to color when pointed at. | | **Label** | On a block: small capitals above the caption. | The sample captions show to shoppers until you replace them. Every setting: [Portrait grid reference](https://spellnsell.com/themes/kera/docs/reference/sections/portrait-grid) ::: ## Services Up to 3 tiles side by side. An image tile has a photo, text and a link; a list tile has up to 4 rows of links. 1. Add a **Services** section. It starts with an **Image tile** and a **List tile**. 2. In the image tile, choose an **Image**, replace the text, and set a **Link**. 3. In the list tile, replace the **Heading** and rows, and set a link for each row. :::details Services settings | Setting | What it does | | --- | --- | | **Link label** | Image tile: the link shows only with both a label and a **Link**. | | **Row 1 label** | List tile: the row's name. Rows 2 to 4 work the same. A row shows only with a label. | | **Row 1 detail** | List tile: a short line beside the label. | | **Row 1 link** | List tile: a row with a link shows an arrow. | On phones, the tiles stack. Every setting: [Services reference](https://spellnsell.com/themes/kera/docs/reference/sections/services) ::: ## FAQ Questions that open in place. See [FAQ page](https://spellnsell.com/themes/kera/docs/pages/faq) to set it up. ## Call to action band An eyebrow, heading and text on one side, and a text link and a button on the other. 1. Add a **Call to action band** section. 2. Replace the **Text**. 3. Set a **Text link label** and **Text link**, and a **Button label** and **Button link**. :::details Call to action band settings | Setting | What it does | | --- | --- | | **Text link label** | The link shows only with both a label and a **Text link**. | | **Button label** | The button shows only with both a label and a **Button link**. | Can also go in the footer group. Every setting: [Call to action band reference](https://spellnsell.com/themes/kera/docs/reference/sections/cta-band) ::: ## Countdown A timer to an end date. Every visitor sees the same end moment, and it never restarts. 1. Add a **Countdown** section and choose a **Layout**. 2. Type the **End date** as YYYY-MM-DD and the **End time** as HH:MM. 3. Choose what happens **When the countdown ends**. 4. Set a **Button label** and **Link**. :::note With a wrong date or time format, shoppers see nothing. The editor shows a hint. ::: :::details Countdown settings | Setting | What it does | | --- | --- | | **Layout** | **Bar**, **Image with text** or **Banner**. | | **End date** | For example 2026-12-31, in your store's time zone. | | **End time** | 24-hour clock, such as 18:00. Empty means 00:00. | | **When the countdown ends** | **Hide section**, or **Show a message** with the **Message** you type. | Can also go in the header and footer groups, for example as a bar above the header. Every setting: [Countdown reference](https://spellnsell.com/themes/kera/docs/reference/sections/countdown) ::: ## Icons with text Up to 6 short promises with icons, such as delivery and returns. Installs in the footer group, so it shows on every page. 1. Click **Icons with text** in the footer area of the sidebar, or add a new one. 2. In each item, choose an **Icon** or a **Custom icon**, and replace the **Heading** and **Text**. 3. For more, click **Add block** > **Item**. :::details Icons with text settings | Setting | What it does | | --- | --- | | **Layout** | **Icon above text** or **Icon beside text**. | | **Layout on mobile** | **Stacked**, or **Carousel** with 2 or more items. | | **Custom icon** | On an item: replaces the icon. Use a square image. | | **Link label** | On an item: without it, the heading is the link. | Every setting: [Icons with text reference](https://spellnsell.com/themes/kera/docs/reference/sections/icons-with-text) ::: --- # Video sections > Add Video carousel, Video reels or Video feature to a page, and set each one up in a few steps. Source: https://spellnsell.com/themes/kera/docs/sections/video · Kera 1.0.0 · Updated 2026-11-14 **Where:** Online Store > Themes > Customize > Add section Three video sections, under **Video and images** in the section list. All videos start muted. | Section | What it's for | | --- | --- | | [Video carousel](#video-carousel) | Short clips of pieces being worn, each with its product and a bag button | | [Video reels](#video-reels) | Rows of video cards in tabs, opening full screen with sound | | [Video feature](#video-feature) | One video shown large, with a heading | New to the editor? See [How the editor is organized](https://spellnsell.com/themes/kera/docs/get-started/editor-basics). Upload videos in **Content > Files**, or straight from the video setting. :::sidekick Open Sidekick in the theme editor and paste this, with your own names. Check the preview, then click **Save**. ```sidekick Add a Video reels section to the home page with Tab blocks labeled "Rings" and "Earrings". Turn on Fill empty tabs automatically and choose the collection "All jewelry". ``` ::: ## Video carousel ![A video carousel titled "Seen on you", with a product tag under the middle video](https://spellnsell.com/themes/kera/img/video.webp) One clip in the middle with its neighbors to the sides, each with its product and a bag button underneath. 1. Add a **Video carousel** section. It starts with 5 **Video** blocks. 2. In each block, choose a **Video**. Short, portrait clips work best. 3. Choose the **Product** shown under the clip. 4. For more clips, click **Add block** > **Video**. Up to 10. :::details Video carousel settings | Setting | What it does | | --- | --- | | **Autoplay** | Plays muted and moves to the next clip when one ends. | | **Seconds per image** | 3 to 12. How long a block without a video stays. | | **Product button** | **Add to bag** or **View product**. With **Add to bag**, products with options open a quick view. | | **Image** | On a block: shown when there is no video. | A sold-out product shows an arrow to the product page instead of the bag button. Every setting: [Video carousel reference](https://spellnsell.com/themes/kera/docs/reference/sections/video-carousel) ::: ## Video reels Rows of portrait video cards in tabs. Tapping a card opens the section's clips full screen, with sound. 1. Add a **Video reels** section. It starts with three tabs and two **Video card** blocks under each of the last two. 2. In each **Video card**, choose a **Video** and its **Product**. 3. For a tab, click **Add block** > **Tab** and set its **Label**. Cards below a tab block belong to that tab. 4. Drag cards under the right tab. Up to 50 blocks in all. :::details Video reels settings | Setting | What it does | | --- | --- | | **Fill empty tabs automatically** | A tab without cards shows products from **Collection** whose title, type or tags contain the tab's name as a whole word. | | **Cards per tab** | 2 to 8. How many cards a tab fills itself with. | | **Card width on phones** | 60 to 90% of the screen. | | **Show videos from every tab** | On a tab: for an "All" tab. | | **Focus** | On a card: the part of the clip kept in view. | With no tab blocks, all cards show in one row. Every setting: [Video reels reference](https://spellnsell.com/themes/kera/docs/reference/sections/video-reels) ::: ## Video feature One video with an eyebrow and a heading. It plays while in view and pauses when scrolled away. 1. Add a **Video feature** section. 2. Choose a **Video**. Optional: set a **Mobile video**, such as a portrait cut. 3. Choose a **Height**. Turn on **Full width** to run the video edge to edge. :::details Video feature settings | Setting | What it does | | --- | --- | | **Play automatically** | Off shows the preview image with a play button, and the video loads only when pressed. | | **Height** | **Medium** or **Large**. | | **Full width** | Runs the video edge to edge. As the first section, with **Top spacing** set to **None**, it can sit under a transparent header. | Visitors who prefer reduced motion see only the preview image. Every setting: [Video feature reference](https://spellnsell.com/themes/kera/docs/reference/sections/video-feature) ::: --- # Lookbook > Build a shoppable lookbook page where each look adds its pieces to the bag, and link to it from a carousel of looks. Source: https://spellnsell.com/themes/kera/docs/sections/lookbook · Kera 1.0.0 · Updated 2026-11-15 **Where:** Online Store > Themes > Customize > Add section Two sections for looks, under **Storytelling** in the section list: the Lookbook itself, and a carousel that leads to it. | Section | What it's for | | --- | --- | | [Lookbook](#lookbook) | A page of full-width looks, each with its pieces and an **Add the look** button | | [Lookbook carousel](#lookbook-carousel) | A row of look cards that link to the lookbook, for example on the home page | New to the editor? See [How the editor is organized](https://spellnsell.com/themes/kera/docs/get-started/editor-basics). :::sidekick Open Sidekick in the theme editor and paste this, with your own names. Check the preview, then click **Save**. ```sidekick In the Lookbook section on the lookbook page, add a Look block with the heading "Morning gold" and the products "Pearl drop earrings" and "Chain bracelet" as its Pieces. ``` ::: ## Lookbook ![A lookbook titled "Winter 26 — Quiet metals" with an intro text and a large editorial photo of gold ear cuffs and chain bracelets](https://spellnsell.com/themes/kera/img/lookbook.webp) Full-width looks between an intro and an outro. Each look lists its pieces, and **Add the look** puts every piece in stock in the bag. 1. In **Online Store > Pages**, open or add the page and set **Theme template** to **lookbook**. It already has a Lookbook section. 2. In the editor, open that page, click the **Lookbook** section and choose a **Look style**. 3. Click **Add block** > **Look**. Set the **Image** and **Heading**, and choose up to 6 products in **Pieces**. Up to 12 looks. 4. Fill in the intro and outro settings. :::details Lookbook settings | Setting | What it does | | --- | --- | | **Look style** | **Full, opens to split**: **Shop the look** opens the pieces beside the photo. **Always split**: side by side from the start. **Full only**: **Shop the look** goes to the look's **Link**. | | **Image side when split** | **Left**, **Right** or **Alternate**. | | **Add the look label** | The button also shows the total price of the pieces in stock. Empty hides it. | | **Link** | Outro: the button shows only when this is set. | | **Mobile image** | On a look: shown on phones, at 4:5. | | **Open the pieces on load** | On a look, with **Full, opens to split**: that look starts with its pieces open beside the photo. Shoppers can still close them. | **Add the look** adds each piece in stock as its first available variant. A look without pieces shows as **Full only**. Every setting: [Lookbook reference](https://spellnsell.com/themes/kera/docs/reference/sections/lookbook) ::: ## Lookbook carousel A row of tall look cards, each with its name and the total price of its pieces, linking to your lookbook. 1. Add a **Lookbook carousel** section. It starts with 4 **Look** cards. 2. In each card, set the **Image** and **Heading**, and choose the look's **Pieces**. 3. Click the section and set **Link** to your lookbook page. 4. Optional: give a card its own **Link**, such as your lookbook page with `#look-2` at the end, to open that look. :::note The carousel doesn't read the Lookbook section. Set the same image, heading and pieces on both. ::: :::details Lookbook carousel settings | Setting | What it does | | --- | --- | | **Link** | Used by the heading link and every card without its own link. | | **Card link label** | The link on each card. | | **Cards per view on desktop** | 2 to 5. A fraction such as 3.3 lets the next card peek in. | | **Image ratio** | **Portrait**, **Tall** or **Square**. | | **Pieces** | On a card: up to 6 products, used only for the piece count and total price. | A card with no link, and no section **Link**, isn't clickable. Every setting: [Lookbook carousel reference](https://spellnsell.com/themes/kera/docs/reference/sections/looks-slider) ::: --- # Newsletter, popup and reviews > Collect email sign-ups with a newsletter band or popup, show customer quotes, and add an image grid that links to your social profile. Source: https://spellnsell.com/themes/kera/docs/sections/newsletter-and-reviews · Kera 1.0.0 · Updated 2026-11-15 **Where:** Online Store > Themes > Customize > Add section Four sections that collect signups or show what customers say. Signups need no app: each becomes a customer in **Customers**, tagged `newsletter` and subscribed to email marketing. | Section | What it's for | | --- | --- | | [Newsletter](#newsletter) | An email sign-up band on any page or in the footer | | [Newsletter popup](#newsletter-popup) | A sign-up popup that opens after a delay or on scroll | | [Testimonials](#testimonials) | Customer quotes, one at a time | | [Image grid](#image-grid) | A row of square images that link to your posts or products | New to the editor? See [How the editor is organized](https://spellnsell.com/themes/kera/docs/get-started/editor-basics). :::sidekick Open Sidekick in the theme editor and paste this, with your own words. Check the preview, then click **Save**. ```sidekick Add a Testimonials section to the home page above the footer, with three Testimonial blocks. Use these quotes and names: "I never take it off", Anna; "Light enough to sleep in", Maya; "The perfect gift", Lea. ``` ::: ## Newsletter ![A light gray band with the eyebrow The Kera letter, the heading "New pieces and studio notes, once a month", a short line of text and an email field with an arrow button](https://spellnsell.com/themes/kera/img/newsletter.webp) An email field with an eyebrow, heading and text. After signing up, the field is replaced by a thank-you line. 1. Add a **Newsletter** section. It's under **Utilities and layout**. 2. Set the **Text**, for example what subscribers get. :::details Newsletter settings | Setting | What it does | | --- | --- | | **Text** | A line under the heading. | It goes in any template and in the footer group. The **blog** template includes one. The footer also has its own Newsletter block: see [Footer](https://spellnsell.com/themes/kera/docs/header-footer/footer). Every setting: [Newsletter reference](https://spellnsell.com/themes/kera/docs/reference/sections/newsletter) ::: ## Newsletter popup A popup with an optional image and a sign-up form. Installs on, showing on the home page. 1. In the sidebar, under **Overlays**, click **Newsletter popup**. The preview opens the popup. 2. Set **Show on**, **Show after** and **After closing, show again after**. 3. Choose an **Image** and fill in the sign-up form. 4. Fill in the message shown **After signing up**. :::note To turn the popup off, hide or remove the section. The timing rules apply only on your live store, not in the editor. ::: :::details Newsletter popup settings | Setting | What it does | | --- | --- | | **Show on** | **Home page only** or **All pages**. | | **Show after** | 0 to 60 seconds. | | **Also show halfway down the page** | Opens at halfway down if that comes first. | | **After closing, show again after** | 1 to 90 days. Visitors who sign up don't see it again. | | **Show teaser after closing** | A small button in a bottom corner that opens the popup again. | It never opens for signed-up visitors or while another overlay, such as the bag, is open. Every setting: [Newsletter popup reference](https://spellnsell.com/themes/kera/docs/reference/sections/newsletter-popup) ::: ## Testimonials ![A testimonials section: a large customer quote, a short text, the reviewer's name with the product they wear, and arrows with a 01 / 04 counter](https://spellnsell.com/themes/kera/img/newsletter-and-reviews.webp) Customer quotes you type in, one at a time, changed with arrows or a swipe. 1. Add a **Testimonials** section. It starts with 3 **Testimonial** blocks. 2. In each block, replace the sample **Quote**, **Text** and **Name**. 3. Optional: choose the **Product** the customer wears. 4. For more quotes, click **Add block** > **Testimonial**. Up to 12. :::details Testimonials settings | Setting | What it does | | --- | --- | | **Intro** | A line of text under the heading. | | **Show rating** | Shows each testimonial's **Rating**, 0 to 5 stars. | | **Quote** | On a block: quotation marks are added for you. | | **Product** | On a block: shows the product's image and name, linking to it. | | **Detail** | On a block: for example the city. Shown when no product is chosen. | Reviews from a reviews app need the app's own block, not this section. Their star ratings show on product cards and in the **Rating** block: see below. Every setting: [Testimonials reference](https://spellnsell.com/themes/kera/docs/reference/sections/testimonials) ::: ## Star ratings from a reviews app Kera shows star ratings from your reviews app on product cards and on the product page. Judge.me, Loox, Okendo, Yotpo, Stamped and most other reviews apps keep Shopify's standard rating and review count up to date for each product, and the theme reads those. Nothing shows on products without reviews. 1. Install your reviews app and let it sync your reviews. 2. Product cards: in **Theme settings > Product cards**, **Show star rating** installs on. Stars and the count, such as `(21)`, show under the price. 3. Product page: open a product template, select **Product information**, click **Add block** > **Rating**, and drag it under the title. 4. To show the reviews themselves, add the app's reviews block, for example in an **Apps** section below the product. :::details Rating block settings | Setting | What it does | | --- | --- | | **Show review count** | Shows the number of reviews after the stars. Installs on. | When the page has the reviews app's widget, clicking the stars scrolls down to it. Without one, the stars are plain text. On a product without reviews the block shows nothing; in the theme editor it shows a short note instead. ::: :::details Good to know about star ratings - A rating out of 10 or another scale shows out of 5 stars. Partial stars show the exact rating, so 4.7 fills most of the fifth star. - Screen readers hear the rating as a sentence, such as "4.7 out of 5 stars, 21 reviews". - The rating and review count are also added to the product's structured data for search engines. - An **Apps** section whose app shows nothing for a product, such as a reviews widget with no reviews yet, leaves no empty space. ::: ## Image grid A row of square images you upload, each linking to a post or product, under your handle. It doesn't connect to a social network. 1. Add an **Image grid** section. It's under **Video and images** and starts with 6 **Image** blocks. 2. Set the **Handle**, such as your Instagram name, and the **Profile link**. 3. In each block, choose an **Image** and set its **Link**. Up to 12. :::details Image grid settings | Setting | What it does | | --- | --- | | **Handle** | Shown as the heading. Empty shows none. | | **Profile link** | Makes the handle a link, opened in a new tab. | | **Columns on desktop** | **4** or **6**. Phones and tablets show 3. | | **Full width** | Runs the images edge to edge. | | **Caption** | On a block: shown on hover, and always on touch screens. | Use square images; others are cropped. For full rows, add a multiple of the columns. Every setting: [Image grid reference](https://spellnsell.com/themes/kera/docs/reference/sections/social-grid) ::: ## Good to know :::details Where do I find people who signed up? In **Customers**. Filter by the tag `newsletter` or by email subscription status. To send emails, use Shopify Email or another email app. ::: --- # Media gallery and full-screen viewer > Set the product gallery's layout, photo shape and fit, show only the chosen variant's photos, add labels from alt text, and set up the full-screen viewer. Source: https://spellnsell.com/themes/kera/docs/product-page/media-gallery · Kera 1.0.0 · Updated 2026-11-16 **Where:** Online Store > Themes > Customize > Products > Default product > Product information > Media gallery The **Media gallery** block shows the product's photos, videos and 3D models, and opens them in a full-screen viewer. It's fixed in **Product information**: you can change its settings but not move it. The **Featured product** section uses the same block. ![A Signet ring product page with a two-column photo gallery beside the product information](https://spellnsell.com/themes/kera/img/media-gallery.webp) ## Set it up 1. Select the **Media gallery** block and pick a **Layout**: **Two columns**, **One column**, **Editorial**, **Thumbnails** or **Slideshow**. 2. Pick a **Gallery size**: **Framed** stays inside the page margins; **Full view** runs to the screen edge and fills the screen height on desktop. 3. Pick a **Photo shape** and a **Photo fit**: **Fill (crop to the box)** or **Fit (show the whole photo)**. 4. Optional: turn on **Selected variant photos only** to show just the chosen variant's photos. :::tip Mixed photo shapes on a plain studio backdrop? Pick one fixed **Photo shape** with **Photo fit** set to **Fit (show the whole photo)**. They line up without cropping. ::: On phones every layout shows one photo at a time, swiped. ## Settings :::details Layout settings Install states are for the default product template. **Layout**: how the photos sit beside the product information. Installs as **Thumbnails**. ![The top of a product page in each Layout: Two columns, One column, Editorial, Thumbnails, Slideshow](https://spellnsell.com/themes/kera/img/preview-gallery-layout.webp) | Setting | What it does | | --- | --- | | **Gallery size** | **Framed** or **Full view** (right under the header). Hidden for **Editorial**, which always works as **Full view**. Installs as **Full view**. | | **Thumbnail position** | **Left**, **Right** or **Below**, on desktop. **Thumbnails** only; phones show them below. Installs as **Below**. | | **Current thumbnail** | **Fade the others** or **Frame**. **Thumbnails** only. Installs as **Fade the others**. | | **Line and counter color** | **Slideshow** only. **Automatic, per photo**, **Dark, for light photos** or **Light, for dark photos**. Installs as **Automatic, per photo**. | | **Sticky gallery on desktop** | Keeps the gallery in place while the information scrolls. Always on in **Full view** with **Thumbnails** or **Slideshow**; hidden for **Editorial**. Installs on. | | **Gallery and information gap** | On the **Product information** section: the space beside the gallery, 0 to 160, narrower on small desktop screens. | ::: :::details Photo settings | Setting | What it does | | --- | --- | | **Photo shape** | **Original (each photo's own shape)**, **Tall 2:3**, **Portrait 3:4**, **Portrait 4:5**, **Square**, **Landscape 4:3** or **Wide 16:9**. In **Full view** and **Editorial**, the screen height sets the box on desktop. Installs as **Portrait 4:5**. | | **Photo fit** | **Fill (crop to the box)**: crops photos whose shape differs from the box, so keep the piece away from the edges. **Fit (show the whole photo)**: space around it. Installs as **Fit (show the whole photo)**. | | **Space around the photo** | With **Fit (show the whole photo)**. **Drawn out from the photo** extends a plain backdrop, or uses the page color where there is none. **Page background**, or **Custom color** set in **Background color**. Installs as **Drawn out from the photo**. | | **Selected variant photos only** | Shows only the chosen variant's photos. Installs on. | | **Play videos automatically** | Videos uploaded to Shopify play muted on a loop, without controls, with a pause button in the corner; a click anywhere on the video pauses or plays it. They play only while on screen, fade back into their first frame at the end of each loop, and show in the full-screen viewer too. Shoppers who ask their device for reduced motion see the video's first image and a play button. YouTube and Vimeo videos still play on a click. Installs on. | | **Show labels from alt text** | Turns words in square brackets in a photo's alt text, such as `[Bestseller]`, into labels on the photo. Shopping feeds may still show the brackets. See [Labels in square brackets](https://spellnsell.com/themes/kera/docs/store-data/labels). Installs on. | ::: :::details Full-screen viewer settings | Setting | What it does | | --- | --- | | **Full-screen image viewer** | Clicking a photo opens it full screen. Installs on. | | **Image size** | **Whole image** shows all of it. **Full width** fills the whole screen: on larger screens the photo spans the width and scrolls down; on phones it fills the height and pans sideways. Installs as **Whole image**. | | **Show an image size button** | Switches between whole image and full width. Installs on. | | **Full width opens at** | Where a photo taller than the screen starts at full width: **Top**, **Middle** or **Bottom**. Phones show the full height and open at the middle of the photo's width. Installs at **Top**. | | **Image indicators** | **Thumbnails** or **Lines and counter**. Installs as **Thumbnails**. | | **Show arrows** | Installs on. | | **Full-width control buttons** | Gives the close button, arrows and indicators a solid background, for when they are hard to see. Shown when **Image size** is **Full width** or the size button is on. Installs off. | | **Controls color scheme** | Colors of those buttons. | ::: ## Good to know :::details How does Selected variant photos only pick photos? Give each variant its own image (Products > your product > the variant), and order the media so each variant's image comes first, then its other photos. A variant's photos run up to the next image another variant uses. Photos before the first variant image are shared and stay first in the gallery, so a video placed first in the media plays first for every variant. Add `#all` to an alt text, such as `Gift box #all`, to show that photo for every variant. A variant with no image shows every photo. With the setting off, all photos show and picking a variant moves to its image. ::: :::details How do 3D models and "View in your space" work? Add a 3D model (GLB or USDZ) to the product's media in the Shopify admin. It shows in the gallery with a 3D icon, and shoppers tap it to turn and zoom the model. On phones that support AR, a **View in your space** button appears under the gallery and opens the model at true size. It needs no setting. ::: --- # Variant picker and size help > Choose how product options show, add a size guide link and size notes, or move the size option into a side drawer that guides the choice. Source: https://spellnsell.com/themes/kera/docs/product-page/variant-picker · Kera 1.0.0 · Updated 2026-11-14 **Where:** Online Store > Themes > Customize > Products > Default product > Product information > Variant picker The **Variant picker** block shows options such as Metal and Size, and updates the price, photo and Add to bag button on each pick. Add size help as a size guide link, a note beside each size, or a drawer for one option. ![The product information column: title, price, metal swatches, a "Find your size" row, add-on checkboxes, Add to bag and Buy it now](https://spellnsell.com/themes/kera/img/variant-picker.webp) ## Set it up 1. Select the **Variant picker** block and pick a **Style** and **Option size**. 2. In **Options with size help**, type the option names exactly as on your products. Separate several with commas. 3. Set the **Size guide link** text. It opens your size guide page in a side drawer; see [Size guides](https://spellnsell.com/themes/kera/docs/product-page/size-guides). 4. Optional: to move an option into a drawer, type it in **Option name** and set the **Row label**, such as "Find your size". :::note Size help works only when the option shows as buttons or a dropdown, not as swatches or photos. ::: ## Settings :::details Style settings **Style**: how the options look. Installs as **Squares**. Swatch styles apply to options with swatches, such as Metal; others, such as Size, stay buttons. ![A ring's Metal and Size options in each Style: Buttons, Color circles, Squares, Variant images, Variant tiles, Dropdown](https://spellnsell.com/themes/kera/img/preview-picker-style.webp) | Setting | What it does | | --- | --- | | **Option size** | **Small**, **Medium** or **Large**. Not shown for **Dropdown**. Installs as **Medium**. | ::: :::details Size help settings | Setting | What it does | | --- | --- | | **Options with size help** | Options that get the link, notes and help line. Installs as `Size`. | | **Size guide link** | Installs as "Size guide". Shows only when a size guide page with content is found. | | **Line under the sizes** | A short line under the values. Can include a link. | | **Size guide page for this block** | Fallback page. Empty uses **Theme settings > Drawers and overlays > Size guide page**. | ::: :::details Drawer settings | Setting | What it does | | --- | --- | | **Option name** | The option that moves into a drawer. Several names allowed; the first one the product has is used. Empty shows all options inline. | | **Row label** | The row that opens the drawer. Installs as "Find your size". | | **Help link in the drawer** | Opens the size guide page inside the drawer. | | **Text under sizes** | Shown under the values. `[price]` shows the chosen variant's price. | | **Photos heading** | Heading over the photos per size. Installs as "Shown worn". | ::: ## Good to know :::details Where do swatch colors and photos come from? From each value's swatch in the Shopify admin (Products > your product > the option). A value without one still shows a color when its name is a known metal; otherwise **Color circles** and **Squares** show buttons. **Variant images** and **Variant tiles** show photos only for an option whose values lead to at least two different variant images, so give each variant its own image. Sold-out values stay visible, marked Sold out. ::: :::details How does the size drawer behave? It opens from the row; on phones it's a bottom sheet. Until a value is picked, Add to bag opens the drawer, and the value picked there goes straight into the bag. The drawer lists each value with its note, a necklace length drawing when all values are 40, 45 or 50 cm, a photo per size when sizes have different variant images, and the size guide page's first numbered list as steps. ::: --- # Size guides > Write size guide pages, decide which page each product opens, and show the guide in a side drawer from the product page. Source: https://spellnsell.com/themes/kera/docs/product-page/size-guides · Kera 1.0.0 · Updated 2026-11-14 **Where:** Online Store > Themes > Customize > Theme settings > Drawers and overlays > Size guide page A size guide is an ordinary page in **Online Store > Pages**, opened from the product page in a side drawer (a bottom sheet on phones). Write one for the whole store, one per product type, or one per product. ![The "Choose your size" drawer open over the product page, listing sizes with a "Need help? Measure at home" link](https://spellnsell.com/themes/kera/img/size-guides.webp) ## Set it up 1. In **Online Store > Pages**, create a page such as "Size guide" and add your content. 2. In the editor, open **Theme settings > Drawers and overlays** and pick it in **Size guide page**. 3. The **Variant picker** already shows a Size guide link beside Size. Add a **Size guide** block only to a template for products without a size option. 4. Optional: for a guide per product type, create a page with the handle `size-guide-` plus the type, such as `size-guide-rings`. :::note Use either the **Size guide** block or the [Variant picker](https://spellnsell.com/themes/kera/docs/product-page/variant-picker) size link, not both. With both, the product shows two links. ::: :::sidekick Open Sidekick in the theme editor and paste this, with your own names. Check the preview, then click **Save**. ```sidekick In Theme settings > Drawers and overlays, set Size guide page to my page "Size guide". ``` ::: ## Settings :::details Size guide block settings | Setting | What it does | | --- | --- | | **Label** | The link text. Installs as "Size guide". | | **Page for this block** | Used when the product has no guide of its own and no type page. Empty uses **Theme settings > Drawers and overlays > Size guide page**. | The drawer's colors are set in **Theme settings > Drawers and overlays > Product and filter drawers**, shared with the engraving and filter drawers. ::: ## Good to know :::details Which page does a product open? The first one found, in this order: the product's `custom.size_guide` metafield (a page reference); a page with content and the handle `size-guide-` plus the product type; the page picked in the block (**Page for this block**, or **Size guide page for this block** on the Variant picker); then **Size guide page** in Theme settings. If none is found, or the page is empty, the link doesn't show; in the editor the block shows a note. ::: :::details How do I name a product type page? Use `size-guide-` plus the type in lowercase, spaces turned into hyphens: Rings becomes `size-guide-rings`, Ear cuffs `size-guide-ear-cuffs`. Set the handle under the page's search engine listing. An empty page is skipped. Earrings and rings can each have their own: `size-guide-earrings` and `size-guide-rings`. ::: :::details How do I give one product its own guide? In **Settings > Metafields and metaobjects > Products**, add a metafield definition `custom.size_guide` of type **Page**. Then pick the page in that metafield on the product. ::: :::details How should I write the page? The Size guide block shows the whole page. The variant picker's size help also reads parts of it. In the first table, a row whose first cell matches a size value (ignoring capitals) gives it a note from the second cell: `52 | US 6` reads "52 (US 6)". In the size drawer, the first numbered list shows as steps, such as how to measure at home, and the rest opens from the help link. ::: --- # Engraving and add-ons > Take engraving text on the product page, and offer free or paid extras such as gift wrapping that go into the bag with the piece. Source: https://spellnsell.com/themes/kera/docs/product-page/engraving-and-add-ons · Kera 1.0.0 · Updated 2026-11-14 **Where:** Online Store > Themes > Customize > Products > Default product > Product information > Add block > Engraving Two blocks, no app needed. **Engraving** takes a line of text and saves it on the order line. **Optional extra** is a tick box for an extra, such as gift wrapping, with an optional text field; paid extras are charged through a product of their own. ![The Engraved pendant product page: an engraving preview reading "Emma" on the pendant photo, shape options and add-on checkboxes](/themes/kera/img/engraving-and-add-ons.webp "The preview on the photo comes from the Engraving studio section.") ## Set it up 1. In the Shopify admin, open a product and set **Theme template** to **engraving**. 2. In the editor, open **Products > engraving**. For free engraving, click the eye icon on the hidden **Engraving** block and remove the first **Add-on**. For paid engraving, keep that Add-on and pick its **Add-on product**. 3. On the **Engraving** block, set **Label**, **Maximum characters** and, if every order needs it, **Required**. 4. For another paid extra, such as gift wrapping, create a product and pick it as an **Optional extra** block's **Add-on product**. Leave it empty for a free extra. :::note **Helper text** is only a hint. The field doesn't block other characters; it only stops at **Maximum characters**. ::: For shapes, several lines, lettering and a preview on the photo, see [Engraving studio](https://spellnsell.com/themes/kera/docs/jewelry-tools/engraving-studio). :::sidekick Open Sidekick in the Shopify admin and paste this, with your own names and numbers. Check what it fills in before you save. ```sidekick Set the theme template to "engraving" for every product in the Engravable collection. ``` ```sidekick Create a product called "Gift wrapping" priced at €6, with inventory not tracked. ``` ::: ## Settings :::details Engraving block settings | Setting | What it does | | --- | --- | | **Display** | **In the page** or **Row that opens a drawer** (a bottom sheet on phones). The row shows the text once typed. Installs as **In the page**. | | **Row label** | Drawer only. Installs as "Add an engraving". | | **Label** | The field label and the name the text is saved under on the order. Installs as "Engraving". | | **Placeholder** | Installs as "Initials or a date". | | **Helper text** | A hint under the field. Installs as "Letters, numbers and spaces". | | **Maximum characters** | 4 to 40, default 12. A counter shows the characters left. | | **Required** | Installs off. When off, the label shows "(optional)". | | **Show live preview** | Shows the typed text in a preview line. Installs on. | ::: :::details Add-on block settings | Setting | What it does | | --- | --- | | **Label** | Text next to the tick box. | | **Add-on product** | Added to the bag with the piece. Empty makes a free extra. | | **Show a text field** | Opens a field when the box is ticked. Installs on. | | **Field name** | The name the text is saved under on the order. Installs as "Gift note". Empty uses **Label**. | | **Placeholder** | Sample text in the empty field. | | **Maximum characters** | 4 to 200, default 120. | | **Helper text** | A line under the field. | | **Text required when ticked** | The ticked box needs text before Add to bag. Installs off. | ::: ## Good to know :::details Where do I see the engraving text? On the order in the Shopify admin, on the piece's line, under the Engraving **Label** or the Add-on **Field name**. Add-on text goes on the piece's line, not the extra's. ::: :::details How do paid extras work? Its price shows next to the label with a plus sign. When ticked, Add to bag adds it at the piece's quantity, marked "For:" with the piece's name. Changing the piece's quantity changes the extra's; removing the piece removes it. A sold-out add-on product hides the block. Give the extra product a price, keep it out of your collections, hide it from search (see [Metafields the theme reads](https://spellnsell.com/themes/kera/docs/store-data/metafields)), and make sure it's on the Online Store sales channel. ::: :::details Can I use the blocks on other templates? Yes. Add Engraving and Add-on blocks to any product template, and as many Add-on blocks as you need. The engraving template's two Add-on blocks install free, with no **Add-on product**; the first asks for the engraving text when ticked. If Required is on and the Engraving field is in a drawer, Add to bag opens the drawer and asks for the text. ::: --- # Complete the stack and related products > Suggest pieces that wear with the product, add them to the bag in one tap, and show related and recently viewed products under the product. Source: https://spellnsell.com/themes/kera/docs/product-page/complete-the-stack · Kera 1.0.0 · Updated 2026-11-15 **Where:** Online Store > Themes > Customize > Products > Default product > Product information > Complete the stack Four ways to suggest more pieces on the product page. | Feature | Where it lives | Needs Search & Discovery | | --- | --- | --- | | **Complete the stack** | Block in **Product information** | No | | **Complementary products** | Block in **Product information** | Yes | | **Related products** | Section under the product | No, but it lets you pick them | | **Recently viewed** | Section on any template | No | ## Set up Complete the stack The current piece and up to 6 pieces that wear with it, each with a tick box and a running total. One button adds every ticked piece to the bag. 1. Select the **Complete the stack** block. 2. In **Products**, pick up to 6 products, the same for every product. 3. For pieces per product, add a product metafield such as `custom.stack` (**Product**, list of products) in **Settings > Metafields and metaobjects > Products**. Fill it on each product, then connect it to **Products** with the dynamic source icon. :::note **Products** installs empty and not connected to a metafield. Until you fill it, the block shows Search & Discovery's complementary products, or nothing. ::: :::sidekick Open Sidekick in the theme editor and paste this, with your own names. Check the preview, then click **Save**. ```sidekick On the default product template, add a Complete the stack block to Product information under Buy buttons, and pick the products "Pearl drop", "Mini hoop" and "Chain bracelet". ``` ::: ## Settings :::details Complete the stack settings | Setting | What it does | | --- | --- | | **Heading** | Installs as "Complete the stack". | | **Products** | Up to 6 pieces. Connect a product list metafield to set them per product. | | **Include this piece** | Lists the current piece first, following the variant chosen above. Installs on. | | **Show complementary when empty** | With no pieces, shows Search & Discovery's complementary products instead. Installs on. | | **Maximum products** | 1 to 6, default 3. For the complementary products. | ::: :::details Complementary products settings A short "Pairs well with" list with an Add button per piece. Set the pieces in **Apps > Search & Discovery > Product recommendations**, then add the **Complementary products** block to **Product information**. A piece with one variant goes straight into the bag; others open quick view. | Setting | What it does | | --- | --- | | **Heading** | Installs as "Pairs well with". | | **Color scheme** | A scheme other than the page's shows the pieces on a card in that scheme. | | **Maximum products** | 1 to 6, default 3. | ::: :::details Related products settings A grid of cards under the product, picked by Shopify from sales and catalog data, so a new store may show few or none. Add your own in **Search & Discovery > Product recommendations**. Hidden with no recommendations. | Setting | What it does | | --- | --- | | **Eyebrow** | Installs as "You may also like". | | **Heading** | Installs as "More to discover". | | **Rows** | 1 or 2. | | **Columns on desktop** | 3 or 4. | | **Columns on mobile** | 1 or 2. | Every setting: [Related products reference](https://spellnsell.com/themes/kera/docs/reference/sections/product-recommendations). ::: :::details Recently viewed settings Products the shopper opened before, newest first, without the current one. The list lives in the shopper's browser, up to 12 products, and stays hidden until they have viewed another product. | Setting | What it does | | --- | --- | | **Products to show on desktop** | 2 to 8, default 4. | | **Products to show on mobile** | 1 to 8, default 4. On tablets and phones, an odd last product is left out. | Every setting: [Recently viewed reference](https://spellnsell.com/themes/kera/docs/reference/sections/recently-viewed). ::: ## Good to know :::details Complete the stack doesn't show on a product It has no pieces in **Products** or the metafield, and either **Show complementary when empty** is off or there are no complementary products. Sold-out pieces are left out. While it waits for complementary products, the block stays hidden and appears only if some arrive, so it never flashes on and off. In the editor, an empty block shows a note. ::: --- # Sticky Add to bag > Show a copy of the Add to bag button at the bottom of the screen once shoppers scroll past the real one, on phones or on every screen. Source: https://spellnsell.com/themes/kera/docs/product-page/sticky-add-to-bag · Kera 1.0.0 · Updated 2026-11-14 **Where:** Online Store > Themes > Customize > Products > Default product > Sticky add to bag Once the shopper scrolls past Add to bag, a copy slides up at the bottom of the screen. It works exactly like the real button: same variant, label, price and Sold out state. ![A product page scrolled down, with the sticky bar at the bottom showing a thumbnail, the product name, price and Add to bag](https://spellnsell.com/themes/kera/img/sticky-add-to-bag.webp) ## Set it up 1. Select the **Sticky add to bag** section. The default product template has it after Product information; on other product templates, add it with **Add section**. 2. Choose **Show on**: **Phones** (a full-width button) or **Phones and desktop** (adds a bar with the title on larger screens). 3. Optional: set **Show after scrolling** and a **Color scheme**. :::note **Product information** needs a **Buy buttons** block. The sticky button submits that form. ::: To turn it off, hide or remove the section. ## Settings :::details Section settings | Setting | What it does | | --- | --- | | **Show on** | **Phones** or **Phones and desktop**. Installs as **Phones and desktop**. | | **Show product image** | The image in the desktop bar. **Phones and desktop** only. Installs on. | | **Show after scrolling** | 0 to 90%, default 0. How far past Add to bag, as a share of the page, before it shows. | | **Color scheme** | Colors of the bar. | ::: ## Good to know :::details When does it hide? While the footer is on screen, while a drawer such as the cart or size guide is open, and always when the product is sold out. It lays over the page, so nothing moves. In the editor, selecting the section shows the bar without scrolling. ::: :::details The sticky button doesn't show Check for a **Buy buttons** block in **Product information**, that the product isn't sold out, and that you scrolled past the real button. With **Show on** set to **Phones**, it doesn't show on desktop. ::: :::details What if the shopper hasn't picked a size? The same checks run as on the real button. An unpicked size in a size drawer opens the drawer; an empty required engraving opens its field or drawer. See [Variant picker and size help](https://spellnsell.com/themes/kera/docs/product-page/variant-picker) and [Engraving and add-ons](https://spellnsell.com/themes/kera/docs/product-page/engraving-and-add-ons). ::: --- # Drop a hint > Let shoppers send a link to the piece they want, with a short message, by WhatsApp, Viber or their device's share menu. Source: https://spellnsell.com/themes/kera/docs/product-page/drop-a-hint · Kera 1.0.0 · Updated 2026-11-16 **Where:** Online Store > Themes > Customize > Products > Default product > Product information > Drop a hint A small link on the product page opens a drawer (a sheet on phones) with the chosen piece, who it's for and a message. The shopper sends it from their own phone or computer, with a link that opens the same size and finish. Nothing is sent to or kept by your store. ## Set it up 1. Select the **Drop a hint** block in **Product information**. On other product templates, add it with **Add block**. 2. Set the **Label** (installs as "Drop a hint") and, if you like, a **Drawer heading**. 3. Write the **Starting message**. Shoppers can change it before sending. 4. Under **Ways to send**, turn on **WhatsApp**, **Viber** and **Share**. ## What the shopper sees - The piece with the variant and price they chose. It follows the variant picker. - **Who's it for?** and **Their number** (both optional). The number is used by WhatsApp and Viber; left empty, the app asks who to send to. - **Your message**, which opens with "Hi ____,". The blank fills in with the name as they type it. If they leave the name empty, the greeting is left out of what's sent. - Compact send buttons and a one-line privacy note, pinned to the bottom of the drawer while the fields scroll. ## Settings :::details Block settings | Setting | What it does | | --- | --- | | **Label** | The link text on the product page. Installs as "Drop a hint". Empty shows the icon alone. | | **Show icon** | A gift icon before the label. Installs on. | | **Drawer heading** | The drawer's title. Empty uses the label. | | **Intro** | Optional text at the top of the drawer. Installs empty. | | **Starting message** | The message the shopper starts from, after the greeting. | | **WhatsApp** | A WhatsApp button. Installs on. | | **Viber** | A Viber button, on phones only. Installs on. | | **Share** | Opens the device's share menu, which lists every messaging app. Where there is none, it copies the message. Installs on. | ::: ## Good to know :::details What does the recipient get? The greeting, the message and a link to the product with the chosen variant. Most apps show a preview with the variant's photo. ::: :::details Can I change "Hi ____,"? The greeting comes from the theme's language file. Edit it in **Online Store > Themes > ⋯ > Edit default theme content**: search for "Hi". ::: :::details Does my store see the hints? No. The message goes straight from the shopper's phone or computer to the app they choose. ::: --- # Show sizes side by side with Size comparison > Add a section where shoppers slide between sizes in millimeters and see each size worn, with the matching product under it. Source: https://spellnsell.com/themes/kera/docs/jewelry-tools/size-comparison · Kera 1.0.0 · Updated 2026-11-15 **Where:** Online Store > Themes > Customize > Add section > Shopping tools > Size comparison One photo per size, a track of sizes in millimeters, and the product for the size in view. Shoppers drag the track, tap a size, or swipe the photo, and a labeled measure line grows with the size. ![A close-up of an ear wearing a hoop beside a slider of hoop sizes in millimeters and the matching product](/themes/kera/img/size-comparison.webp "Each size has its own photo, measure line and product.") ## Set it up The sizes come from blocks you set up in the section, or from each product's own data. Use the product's data on product templates, so every product shows its own sizes. **From blocks:** 1. Add the **Size comparison** section. It comes with four **Size** blocks (12, 18, 24 and 30 mm). 2. In each **Size** block, set **Size** in mm, upload the **Image** of the piece worn at that size, and choose the **Product**. The product row opens the product at that size. 3. Set **Horizontal position** and **Vertical position** so the measure line sits on the piece. 4. Set **Starting size** to the size shown first. **From the product:** 1. In **Settings > Metafields and metaobjects**, add a metaobject definition named **Size preview** with type `size_preview`. Give it these fields: | Field | Key | Type | | --- | --- | --- | | Label | `label` | **Single line text**, for your own reference | | Image | `image` | **File** (images) | | Size (mm) | `size_mm` | **Decimal** | | Measure line X (%) | `measure_line_x` | **Decimal**: the line's center, from the photo's left edge | | Measure line Y (%) | `measure_line_y` | **Decimal**: the line's top, from the photo's top edge, just under the piece | | Measure line width (%) | `measure_line_width` | **Decimal**: the piece's width, as a share of the photo's width | Turn on **Storefronts API access**. 2. Add a product metafield definition `custom.size_previews`, type **Metaobject**, **List of entries**, pointing at **Size preview**. 3. For each product, add one **Size preview** entry per size and list them in its **Size previews** metafield. 4. In the section, set **Sizes** to **Product metafield**. On a product template, leave **Product** empty to use the page's product. :::tip Shoot every size with the same crop and distance. The line is drawn relative to the photo, so matching framing keeps sizes comparable. ::: ## Settings :::details Section settings | Setting | What it does | | --- | --- | | **Color scheme** | Colors of the section. Default scheme 2. | | **Eyebrow** | Small text above the heading. Default "True to scale". | | **Heading** | The section heading. Line breaks are kept. | | **Heading size** | Extra large, Large, Medium (default), Small or Extra small. | | **Text** | A short paragraph under the heading. | | **Sizes** | **Set in blocks** (default) or **Product metafield**: the product's **Size previews**. | | **Product** | With **Product metafield**: the product whose sizes show. Leave empty on product templates to use the page's product. | | **Size option name** | With **Product metafield**: the option that holds the sizes. Default "Size". | | **Photo note** | With **Product metafield**: a short line under the product row, for example "Shown in yellow gold." | | **Starting size** | The size shown first, in mm. 2 to 100, default 18. If no block has that size, the first block shows first. | | **Top spacing** | None (default), Small, Medium or Large. | | **Bottom spacing** | None (default), Small, Medium or Large. | ::: :::details Size block settings (up to 16 sizes) | Setting | What it does | | --- | --- | | **Tab** | Groups sizes into tracks. Default "Ear". | | **Size** | The size in mm, 2 to 100. Default 18. | | **Image** | The piece worn at this size. | | **Product** | Its first image, name and price show in the row under the controls, and the row links to it. | | **Material** | Text before the size in the product row, for example "Yellow gold". | | **Horizontal position** | Where the measure line sits across the photo, 0 to 100%. Default 50%. | | **Vertical position** | Where the measure line sits down the photo, 0 to 100%. Default 60%. | | **Different position on mobile** | Turns on separate positions for phones, for when phones crop the photo and the line misses the piece. Installs off. | | **Horizontal position on mobile** | The line's horizontal position on phones. | | **Vertical position on mobile** | The line's vertical position on phones. | ::: Every setting: [Size comparison reference](https://spellnsell.com/themes/kera/docs/reference/sections/true-to-scale). ## Good to know :::details How do I show hoops and studs separately? Give blocks a **Tab** name. Sizes with the same name share a track, and two or more names add a row of tabs. Sizes are spaced by value on each track; block order sets the photo order. ::: :::details Which sizes show with Product metafield? A **Size preview** shows when the product sells its size: its **Size (mm)** matches the number in a value of the size option, such as `12 mm` or `1.2 cm`. An entry for a size the product doesn't sell is skipped. A product without a size option shows its entries as they are. An entry without **Size (mm)** shows its photo with no size or line, which suits a product sold in one size. ::: :::details A product has only one size. The slider still shows, with its handle resting on that size, so it doesn't change shape when you add more sizes later. With one size there is nothing to drag. ::: :::details Does choosing a size change the product I'm buying? On the product's own page, yes. Picking a size in the section selects it in the buy box and keeps the other options, such as the metal. Picking a size in the buy box moves the section to it, and the product row shows that variant's price. Elsewhere, the row opens the product at that size. ::: :::details The section is missing on some product pages. With **Product metafield**, the section hides on products that have no **Size previews**. In the theme editor, a note shows in its place. ::: :::details My photos show one metal only. Say so in **Photo note**, for example "Shown in yellow gold.", so shoppers looking at another metal aren't misled. ::: :::details Why does a size have no price or link? Its block has no **Product**. The size still shows, with the tab name and size only. ::: --- # Ear stack builder > Add the Bundle builder section so shoppers see a full ear stack on one photo and add every piece to the bag in one tap. Source: https://spellnsell.com/themes/kera/docs/jewelry-tools/ear-stack · Kera 1.0.0 · Updated 2026-11-14 **Where:** Online Store > Themes > Customize > Add section > Shopping tools > Bundle builder One photo of an ear wearing the stack, a numbered row per piercing, and one button that adds the whole stack to the bag. In the editor the section is called **Bundle builder**. ![The ear stack section: a list of four piercings with prices beside a close-up photo of an ear wearing them](/themes/kera/img/ear-stack.webp "Hovering a row lights up its spot on the photo.") ## Set it up 1. Add the **Bundle builder** section and upload the **Image**: a close-up of the ear wearing the pieces. 2. Select each **Product** block (up to 6). Type the **Piercing** name and choose the **Product**. 3. Drag **Spot horizontal position** and **Spot vertical position** until the spot sits on that piercing. :::note Shoppers can't choose a variant here. Each piece goes in the bag as its first available variant. ::: :::sidekick Open Sidekick in the theme editor and paste this, with your own names. Check the preview, then click **Save**. ```sidekick Add the Bundle builder section to the home page under the first section. Give it three Product blocks: Lobe with "Pearl stud", Helix with "Mini hoop" and Flat with "Star stud". ``` ::: ## Settings :::details Section settings | Setting | What it does | | --- | --- | | **Color scheme** | Colors of the section. Default scheme 2. | | **Image** | The ear wearing the stack. The spots are placed on it. | | **Eyebrow** | Small text above the heading. Default "Ear stack builder". | | **Heading** | The section heading. Line breaks are kept. | | **Heading size** | Extra large, Large, Medium (default), Small or Extra small. | | **Text** | A short paragraph under the heading. | | **Top spacing** | None (default), Small, Medium or Large. | | **Bottom spacing** | None (default), Small, Medium or Large. | ::: :::details Product block settings | Setting | What it does | | --- | --- | | **Piercing** | The piercing's name, shown above the product name and on the photo. Default "Lobe". | | **Product** | The piece for this piercing. | | **Spot horizontal position** | Where the spot sits across the photo, 0 to 100%. Default 50%. | | **Spot vertical position** | Where the spot sits down the photo, 0 to 100%. Default 50%. | ::: Every setting: [Bundle builder reference](https://spellnsell.com/themes/kera/docs/reference/sections/ear-stack). ## Good to know :::details What does the shopper see in each row? A number, the product image, the piercing name, the linked product name and the price. **Total** adds up the pieces that can be bought; when one is on sale, the full total shows crossed out beside it. A sold-out piece stays in the list but is left out of the total and the add. ::: :::details What happens after "Add the stack to bag"? One of each piece goes in the bag. The bag then follows Theme settings > Cart > **After adding to the bag**. See [Cart drawer and cart page](https://spellnsell.com/themes/kera/docs/cart/cart). ::: :::details Why is the add button grayed out? No row has a product that can be bought. Choose a product in at least one row, and check it's in stock and available on the Online Store. ::: :::details Can I use it for rings or necklaces? Yes. It works with any photo and any products. Rename the rows in **Piercing** and change the eyebrow and heading. ::: --- # Charm builder > Add the Add-on builder section so shoppers pick a bracelet or chain plus charms and add them to the bag together. Source: https://spellnsell.com/themes/kera/docs/jewelry-tools/charm-builder · Kera 1.0.0 · Updated 2026-11-15 **Where:** Online Store > Themes > Customize > Add section > Shopping tools > Add-on builder A base piece, such as a bracelet or chain, with charms the shopper adds or takes off with a + / − button. A running total shows the set, and one button adds everything to the bag, each charm as its own line. In the editor the section is called **Add-on builder** and each charm is an **Add-on** block, so it works for any piece with extras. ## Set it up 1. Add the **Add-on builder** section and choose the **Base piece**. 2. Set **Most add-ons in a set**, from 1 to 8 (default 5). 3. Upload an **Image** of the set, worn or laid out. Empty uses the base piece's main image. 4. In each **Add-on** block, choose the charm in **Add-on** and add a **Note**, for example "Polished gold". 5. Turn on **In the set to start** for charms chosen when the page opens. :::note Charms go in the bag as separate products, so nothing tells your team which charms go on which base piece. If you attach charms before shipping, say so in **Note under the button**. ::: ## Settings :::details Section settings | Setting | What it does | | --- | --- | | **Color scheme** | Colors of the section. Default scheme 1. | | **Base piece** | The piece the add-ons go on, for example a bracelet, chain or ring. | | **Most add-ons in a set** | The most charms a shopper can choose. 1 to 8, default 5. | | **Image** | The set, worn or laid out. Empty uses the base piece's photo. | | **Photo position** | Left (default) or Right. | | **Eyebrow** | Small text above the heading. Default "Style your own". | | **Heading** | The section heading. | | **Heading size** | Large, Medium, Small (default) or Extra small. | | **Text** | A paragraph under the heading. `[max]` shows the most add-ons in a set. | | **Button label** | The add button's text. Default "Add the set to bag". | | **Note under the button** | A line of small print under the button. | | **Top spacing** | None (default), Small, Medium or Large. | | **Bottom spacing** | None (default), Small, Medium or Large. | ::: :::details Add-on block settings | Setting | What it does | | --- | --- | | **Add-on** | The charm product. A charm with several variants gets a dropdown in its row. | | **Note** | A short line under the charm's name. | | **In the set to start** | Chooses the charm when the page opens. Installs off. If more charms start in the set than **Most add-ons in a set** allows, the first ones in block order are kept. | ::: Every setting: [Charm builder reference](https://spellnsell.com/themes/kera/docs/reference/sections/charm-builder). ## Good to know :::details What does the shopper see in each charm row? Image, linked name, note, price and + / −. When the set is full, other buttons dim and show "Your set holds up to 5 add-ons. Take one off to add another." ::: :::details What happens with sold-out pieces? A sold-out charm shows "Sold out" and can't be added; in a charm with variants, sold-out variants are disabled in the dropdown. If the base piece is sold out, the button adds the chosen charms only. ::: :::details What does the add button put in the bag? One base piece and one of each chosen charm, each its own line, so one charm can be returned alone. With Theme settings > Buttons > **Show the price on the button**, the total shows on the button. The bag then follows **After adding to the bag** ([Cart drawer and cart page](https://spellnsell.com/themes/kera/docs/cart/cart)). ::: :::details Can shoppers add more than one of the same charm? No. Each charm is either in the set or not. For two of the same charm, the shopper can change the quantity in the bag afterward. ::: :::details Can I give a discount for buying a set? The section doesn't show or apply one. Set up an automatic discount in Shopify admin > Discounts; the bag and checkout then show it. ::: --- # Build a set and its discount > Add the Build a set section and create the matching automatic discount so a complete set is charged at the price the section shows. Source: https://spellnsell.com/themes/kera/docs/jewelry-tools/build-a-set · Kera 1.0.0 · Updated 2026-11-14 **Where:** Online Store > Themes > Customize > Add section > Shopping tools > Build a set Shoppers fill a row of slots from a grid of pieces, then add the whole set to the bag in one tap. The section can show a set discount, for example "Set complete · 15% off at checkout". ![The Build a set section: "Any three, styled together", three empty slots and a row of products to pick from, beside a photo](/themes/kera/img/build-a-set.webp "Tapping a piece fills the next empty slot.") ## Set it up 1. Add the **Build a set** section and upload the **Image**. 2. Pick up to 12 pieces in **Products**, or choose a **Collection** (used only when no products are picked; its first 12 show). 3. Set **Pieces in a set**, from 2 to 5 (default 3). 4. Leave **Set discount** at 0% until the discount below exists. ## Create the discount 1. In Shopify admin, go to **Discounts** > **Create discount** > **Amount off products**. 2. Choose **Automatic discount**, a title such as "Set of 3", and a **Percentage**, for example 15. 3. Under **Applies to**, choose the same products or collection as the section. 4. Under **Minimum purchase requirements**, choose **Minimum quantity of items** and enter **Pieces in a set**. Save. 5. In the editor, set **Set discount** to the same percentage. :::warning **Set discount** only displays the percentage. Without the matching discount in Shopify admin, the bag charges full price. ::: :::sidekick Open Sidekick in the Shopify admin and paste this, with your own names and numbers. Check what it fills in before you save. ```sidekick Create an automatic "Amount off products" discount called "Set of 3": 15% off products in the Stacking rings collection, when the cart has at least 3 of those products. ``` ::: ## Settings :::details Section settings | Setting | What it does | | --- | --- | | **Color scheme** | Colors of the section. Default scheme 1. | | **Image** | The photo beside the builder. | | **Image position** | Left (default) or Right. | | **Eyebrow** | Small text above the heading. Default "Build a set". | | **Heading** | The section heading. Line breaks are kept. | | **Heading size** | Extra large, Large, Medium (default), Small or Extra small. | | **Text** | A paragraph under the heading. | | **Products** | The pieces to choose from, up to 12. | | **Collection** | Used when no products are chosen. Shows its first 12 products. | | **Pieces in a set** | The number of slots. 2 to 5, default 3. | | **Pieces per row on desktop** | 3 (default) or 4. | | **Allow variant selection** | Pieces with options open the quick view to pick one. Installs off. | | **Set discount** | The percentage shown for a complete set. 0 to 50%, default 0. Display only. | | **Top spacing** | None (default), Small, Medium or Large. | | **Bottom spacing** | None (default), Small, Medium or Large. | The tiles follow Theme settings > Product cards for card style, image ratio and text alignment. ::: Every setting: [Build a set reference](https://spellnsell.com/themes/kera/docs/reference/sections/build-a-set). ## Good to know :::details How do shoppers build a set? A tap fills the next slot; tapping the piece or slot again takes it out. With every slot full, a tap swaps out the first piece chosen. A status line counts, for example "2 of 3 chosen · add 1 more for 15% off". On phones, a complete set keeps a copy of the add button at the bottom of the screen. ::: :::details How is the total shown? For a complete set with **Set discount** above 0%, the total drops by that percentage, with the full price crossed out and a "You save" line. Shoppers can also add fewer pieces, without the discount line. The bag then follows **After adding to the bag** ([Cart drawer and cart page](https://spellnsell.com/themes/kera/docs/cart/cart)). ::: :::details Which variant goes in the bag? Its cheapest available variant, the price on its tile. With **Allow variant selection** on, a piece with variants opens the quick view to pick one, and can fill two slots in two variants. This needs the **Quick view** section in Overlays. ::: :::details Does the discount only apply to sets built here? No. Shopify applies it to any bag that meets its rules, including pieces added one by one. If that isn't what you want, keep **Set discount** at 0% and skip the discount. ::: :::details The section shows a discount, but the bag charges full price. Check the discount is active, **Automatic discount**, applies to the same **Specific products** or **Specific collections**, and has a minimum quantity of **Pieces in a set**. Test a full set in your store's preview. ::: --- # Set up the gift finder > Add the Gift finder section, write its questions and answers, and tag products so shoppers get the pieces that fit their answers. Source: https://spellnsell.com/themes/kera/docs/jewelry-tools/gift-finder · Kera 1.0.0 · Updated 2026-11-14 **Where:** Online Store > Themes > Customize > Add section > Shopping tools > Gift finder The gift finder asks a few questions, one at a time, then shows the products that fit the answers best. Answers match products by product tag or by price, and the first result is marked "Best match". ![The gift finder asking "Who is the gift for?" with four answers: For her, For him, For them, For me, honestly](/themes/kera/img/gift-finder.webp "One question at a time; shoppers can go back or start again.") ## Set it up 1. Tag your products to match the answers (**Products** > the product > **Tags**). The installed answers use `earrings`, `necklaces`, `rings`, `chains`, `bracelets`, `charms`, `pendants`, `studs`, `huggies`, `hoops`, `pearls` and `engravable`. 2. Add the **Gift finder** section. It comes with three questions: who it's for, their style and the budget. 3. In **Products from**, choose the collection to pick from. Empty uses all products. 4. In each **Question** block (up to 5), add **Answer** blocks with **Product tags**, or **Budget answer** blocks with a **Minimum price** and **Maximum price**. :::note The finder only looks at the first 50 products of **Products from**, in the collection's sort order. ::: :::sidekick Tag products in the Shopify admin first, then build the questions in the theme editor. Paste each in Sidekick there, with your own names. ```sidekick Add the tag for-her to every product in the Earrings and Necklaces collections. ``` ```sidekick In the Gift finder section, add a Question block "What do they wear most?" with three Answer blocks: Rings (product tags: rings), Earrings (product tags: earrings) and Necklaces (product tags: necklaces). ``` ::: ## Settings :::details Section settings | Setting | What it does | | --- | --- | | **Color scheme** | Colors of the section. Default scheme 1. | | **Eyebrow** | Small text above the steps. Default "Gift finder". | | **Products from** | The collection to match. Empty uses all products. | | **Number of results** | How many products show. 2 to 4, default 3. | | **Result heading** | The heading over the results. An answer to the first question can set its own. | | **Show note** | Shows a note with the results. Installs on. | | **Note** | The note's text, for example about gift wrapping. | | **Top spacing** | None, Small, Medium (default) or Large. | | **Bottom spacing** | None, Small, Medium (default) or Large. | ::: :::details Question block settings | Setting | What it does | | --- | --- | | **Question** | The question's heading. | | **Text** | A line of text under the question. | ::: :::details Answer block settings | Setting | What it does | | --- | --- | | **Label** | The answer's text, for example "For her". | | **Product tags** | Comma-separated tags. Products with any of them match. Empty matches every product. | | **Result heading** | Replaces the result heading when this answer is chosen on the first question, for example "Gifts she'll keep". If several chosen answers have one, the earliest question's wins. | ::: :::details Budget answer block settings | Setting | What it does | | --- | --- | | **Label** | The answer's text. Empty names it from the prices, for example "Under €75", "€75 – €150" or "€150 and up". | | **Minimum price** | Lowest price, included. In store currency. Empty for no minimum. | | **Maximum price** | Highest price, not included. In store currency. Empty for no maximum. | ::: Every setting: [Gift finder reference](https://spellnsell.com/themes/kera/docs/reference/sections/gift-finder). ## Good to know :::details How are tags matched? In handle form: "For her" matches `for-her` or `For her`. A product matches if it has any of the answer's tags. ::: :::details How does a budget answer match? A product matches when its lowest price is at least the minimum and below the maximum. Shoppers paying in another currency see prices converted, and the budget is converted with them. ::: :::details How are results ranked? A budget answer filters first (ignored if nothing fits). Tag answers then score products, earlier questions weighing more, so fitting the first question always ranks higher. Ties keep collection order. Sold-out and hidden products are skipped. ::: :::details Why do the results ignore an answer? When no product fits every answer, the later questions give way first so the finder can still show something. Tag more products so each answer has matches. ::: :::details Why is a product missing from the results? Check it's in the first 50 of **Products from**, in stock, tagged to match, and not hidden from search. To keep items like gift wrapping out, hide them with `seo.hidden`: see [Metafields](https://spellnsell.com/themes/kera/docs/store-data/metafields). ::: --- # Set up the engraving studio > Use the Personalization preview section for a live engraving preview, and the engraving product template for pieces that take an engraving. Source: https://spellnsell.com/themes/kera/docs/jewelry-tools/engraving-studio · Kera 1.0.0 · Updated 2026-11-14 **Where:** Online Store > Themes > Customize > Add section > Shopping tools > Personalization preview An engraving studio for one product: the shopper picks a shape, types up to three lines, chooses a lettering and sees the words on the photo as they type. The engraving is saved on the order. ![The Personalization preview: a pendant engraved "Initials", shape, words and lettering options, and a price breakdown with Add to bag](/themes/kera/img/engraving-studio.webp "Each variant of the product is a shape.") ## Set it up 1. Add the **Personalization preview** section and choose the **Product**. Give each variant its own image so the preview changes with the shape. 2. Select the **Engraving** block (or click the words in the preview). Set **Horizontal position**, **Vertical position**, **Engraving area width** and **Engraving area height** to fit the face of the piece. 3. In each **Line** block (up to 3), set the **Label**, **Characters** and, to charge for it, an **Add-on** product. 4. In each **Lettering** block (up to 3), choose a **Style** and, if it costs extra, an **Add-on**. :::note Add-ons are separate lines in the bag. If the shopper removes the engraved piece or changes its quantity, the add-ons stay. ::: ## Settings :::details Section settings | Setting | What it does | | --- | --- | | **Color scheme** | Colors of the section. Default scheme 1. | | **Product** | The product to engrave. Each variant shows as a shape, with its image. Until it's set, the section shows only in the editor. | | **Image position** | Left (default) or Right. | | **Eyebrow** | Small text above the heading. Default "Engraving studio". | | **Heading** | The section heading. Default "Your engraving". | | **Heading size** | Extra large, Large, Medium (default), Small or Extra small. | | **Material** | Shown after the shape under the preview, for example "Live preview · Oval, 18k gold". | | **Fine print** | Small text under the add button. | ::: :::details Engraving block settings | Setting | What it does | | --- | --- | | **Horizontal position** | 0 to 100%, default 50%. | | **Vertical position** | 0 to 100%, default 60%. | | **Lettering size** | 50 to 200%, default 100%. | | **Space between lines** | 0 to 100%, default 10%. | | **Engraving area width** | The face of the piece as a share of the photo. 10 to 100%, default 35%. Words too long for the area shrink to fit. | | **Engraving area height** | 10 to 100%, default 30%. | | **Engraving color** | Blended into the photo. Default #73541f. | | **Finish** | Engraved (default), Deep cut, Laser or Flat. Engraved and Deep cut add a bright edge under each letter, as on polished metal. | ::: :::details Line block settings | Setting | What it does | | --- | --- | | **Label** | Shown in the field and the price summary, for example "Initials". Default "Engraving". | | **Sample text** | Filled in to start with. | | **Characters** | The most characters. 2 to 30, default 10. | | **Size** | The line's lettering size, 30 to 100%, default 100%. A smaller size suits a second line such as a date. | | **Add-on** | A product added to the bag when this line is filled in. Empty includes the line for free. | The first line is required; the others are optional. ::: :::details Lettering block settings | Setting | What it does | | --- | --- | | **Style** | Serif (default), Sans or Script. Sans uses the theme's body font in capitals. | | **Font** | The font for Serif or Script. | | **Add-on** | A product charged when this lettering is chosen. Empty includes it. | ::: Every setting: [Personalization preview reference](https://spellnsell.com/themes/kera/docs/reference/sections/engraving-studio). ## Good to know :::details What goes in the bag? The chosen shape, with notes on the item: "Engraving" for the first line, each other line under its **Label**, and "Lettering", for example "Lettering: Script". Plus one of each add-on for filled lines and the lettering, marked "For:" with the shape and first line. Then the bag follows **After adding to the bag** ([Cart drawer and cart page](https://spellnsell.com/themes/kera/docs/cart/cart)). ::: :::details How should I set up add-on products? One product per paid extra. Keep them out of collections and hide them from search with `seo.hidden` (see [Metafields](https://spellnsell.com/themes/kera/docs/store-data/metafields)). ::: :::details Is there a simpler engraving product page? Yes: [Engraving and add-ons](https://spellnsell.com/themes/kera/docs/product-page/engraving-and-add-ons). ::: :::details Where do I see the engraving on the order? In Shopify admin, under the engraved item on the order. ::: --- # Compare products > Set up a table that compares up to four products side by side, with a drawing of each piece at true size and up to six rows of details. Source: https://spellnsell.com/themes/kera/docs/jewelry-tools/compare-products · Kera 1.0.0 · Updated 2026-11-14 **Where:** Online Store > Themes > Customize > Add section > Shopping tools > Compare products Up to 4 products side by side, each with photo, name, price, an optional badge and Add to bag. Below: a true size row that draws each piece as a ring at real size, and up to 6 detail rows you type in, such as metal or weight. ## Set it up 1. Add the **Compare products** section to any template, such as a product template or a buying-guide page. 2. Under **Rows**, fill in a label per row, for example "Metal" in **Row 1 label**. 3. Add a **Product** block per column (up to 4). Pick the **Product** and fill **Row 1 value** to **Row 6 value**. 4. For the true size row, set each block's **Diameter** and **Thickness** in mm. 5. Optional: set a **Variant**, a **Badge** such as "Our pick", or **Highlight this column**. :::note A row shows only when its label is filled in. A value in a block alone isn't enough. ::: ## Settings :::details Section settings | Setting | What it does | | --- | --- | | **Eyebrow** | Small text above the heading. | | **Heading** | The table's heading. | | **Text** | A short intro above the table. | | **Highlight columns on hover** | Installs on. Moves the tint to the column pointed at or focused, and back on leaving. | | **Show true size row** | Installs on. | | **Row label** | The true size row's label. Default "True size". | | **Row 1 label** | Rows 2 to 6 work the same way. Clear a label to hide that row. | ::: :::details Product block settings | Setting | What it does | | --- | --- | | **Product** | The product in this column. | | **Variant** | An option value such as Rose gold or 18mm, any capitals. Shows that variant's photo and price, and adds it. An available variant wins over a sold-out one. Blank uses the first available variant. | | **Highlight this column** | Installs off. Tints the column full height. Only the first highlighted product counts. | | **Badge** | Shown on the photo. | | **Diameter** | Outside diameter, 0 to 60 mm, default 20. 0 leaves the drawing out. | | **Thickness** | 0.5 to 10 mm, default 3. | | **Row 1 value** | Rows 2 to 6 work the same way. | ::: [All Compare products settings](https://spellnsell.com/themes/kera/docs/reference/sections/product-compare) ## Good to know :::details What does Add to bag do in each column? One variant, or a matching **Variant**: straight into the bag. Several variants and no **Variant**: quick view, or the product page without the **Quick view** section in Overlays. Subscription-only products and gift cards open quick view. Sold out shows a disabled Sold out button. ::: :::details Is the true size drawing exact? Its size on screen depends on the device and zoom. The ring takes the variant's swatch color, or a metal color matched by name. ::: :::details Can each product page compare different products? No. The table shows the products in its blocks on every page using the template. Create a separate product template per group of products. ::: :::details Where can the section go? Any template, but not the header, footer or overlay groups. ::: --- # Set up the collection page and filters > Lay out the collection grid, add filters from Search & Discovery, and set up sorting, pagination and the sticky navigation bar. Source: https://spellnsell.com/themes/kera/docs/collections/collection-page · Kera 1.0.0 · Updated 2026-11-14 **Where:** Online Store > Themes > Customize > Collections > Default collection > Collection The **Collection** section builds every collection page: title and description, product grid, filters, sorting and paging. It holds three fixed blocks: **Image**, **Filter and sort** and **Navigation bar**. ![A collection page with collection tabs, the Worn / Still toggle, Filter and sort, and a large collection image titled "Rings"](/themes/kera/img/collection-page.webp "The navigation bar sits under the collection image.") ## Set it up 1. Select the **Collection** section. Set **Columns on desktop**, **Columns on mobile**, **Products per page** and **Pagination**. 2. In Shopify admin, install the free **Search & Discovery** app. In its **Filters** page, click **Add filter**, choose a source (Availability, Price, Metal, Size, a metafield…) and drag filters into order. 3. In **Navigation bar**, pick **Collections** for a row of links and turn on **Sticky collection bar** if you want it to stay on screen. 4. In **Image**, choose a **Width** and where the title sits. :::note Filters come from Search & Discovery, not the theme. The theme shows whatever filters the app provides. ::: ## Settings :::details Collection section settings | Setting | What it does | | --- | --- | | **Color scheme** | Colors of the section. | | **Heading** | **Collection title** (default) or **Shop the edit**, used under a Collection banner. | | **Show product count** | Shows the count beside the title. Installs off. | | **Show collection description** | Installs on. | | **Products per page** | 8 to 48, default 24. | | **Pagination** | Load more button (default) or Page numbers. | | **Show worn and still toggle** | Installs on. | | **Columns on desktop** | 3 or 4 (default). | | **Columns on mobile** | 1 or 2 (default). | | **Show filters** | Installs on. | | **Show sorting** | Installs on. | | **Top spacing** | None (default), Small, Medium or Large. | | **Bottom spacing** | None, Small, Medium (default) or Large. | The cards follow Theme settings > Product cards. See [Product cards and badges](https://spellnsell.com/themes/kera/docs/theme-settings/product-cards). ::: :::details Navigation bar block Shows only when it has links, the Worn / Still toggle or Filter and sort. **Collections** and **Show link to all products** make the row of links; **Show product counts** adds counts. **Position** puts it **Below image** (the default) or **Above image**. **Sticky collection bar** keeps it under the header, or at the top of the window when the header doesn't stick. On phones, when the bar has collection links, the Worn / Still toggle moves out of it to just above the products. It has its own **Color scheme**; **Background** is **Solid** or **Blurred** (content shows through). For the toggle, see [Worn / Still toggle](https://spellnsell.com/themes/kera/docs/collections/worn-still). ::: :::details Filter and sort block Styles the Filter and sort button, in the navigation bar on larger screens and floating at the bottom on phones. **Label** replaces the automatic text (Filter and sort, Filter or Sort); **Show icon** turns the icon on or off. Turn on **Own colors** to fill it with a **Color scheme** on every screen size; off, it uses the bar's colors. Hide the block with the eye icon if you don't want filters or sorting on collection pages. ::: :::details Image block **Show collection image** uses the collection's image; **Image** is the fallback. **Width**: **Page width**, **Full width** or **Full screen** (fills the window, leaving room for the navigation bar). **Image ratio** (Original, 16:9, 21:9) doesn't apply to Full screen. Under **Title and breadcrumbs**, **Position** is **Below the image** or **On the image**, with **Position on the image**, **Text color** and **Image shade**. Breadcrumbs also need Theme settings > Layout > **Show breadcrumbs**. ::: Every setting: [Collection reference](https://spellnsell.com/themes/kera/docs/reference/sections/main-collection). ## Good to know :::details How do filters look to shoppers? **Filter and sort** opens a sheet. On phones its button floats at the bottom of the screen while the products are in view. The sheet comes up from the bottom on phones (swipe down to close), from the right on larger screens. The grid refreshes behind it, and the page address updates so a filtered page can be shared. Active filters show as chips with **Clear all**. Sheet colors: **Theme settings > Drawers and overlays > Product and filter drawers**. ::: :::details Why do some filters show as chips or swatches? Filters named with "size", "length" or "chain" show square chips. Values with swatches in Search & Discovery show swatches; without them, common metal names such as Yellow gold get a colored dot. Price shows From and To fields. Other filters are tick boxes. ::: :::details Can cards show the variant that matches a filter? Yes. Turn on **Open on the matching variant** in **Theme settings > Product cards**. With Metal: Sterling silver ticked, cards then show and link to the silver variant. ::: :::details Where does the sort order come from? With **Show sorting** on, sorting is the first group in the Filter and sort sheet. The options come from Shopify. The default is the collection's own order, set in Shopify admin under **Products > Collections** > the collection > **Sort**. ::: :::details The navigation bar doesn't stay on screen. Turn on **Sticky collection bar** in the **Navigation bar** block. On phones only the collection links stick; the Worn / Still toggle stays above the products. ::: --- # Use the Worn / Still toggle > Choose whether product cards show pieces worn or on their own, let shoppers switch, and control the toggle per collection. Source: https://spellnsell.com/themes/kera/docs/collections/worn-still · Kera 1.0.0 · Updated 2026-11-14 **Where:** Online Store > Themes > Customize > Theme settings > Product cards > First image Product cards can open on a photo of the piece worn or on its own. You set the store default; shoppers switch with the **Worn / Still** toggle on collection pages, and their choice follows them across the store. ![A collection grid with the Worn / Still toggle at the top right and a promo card among the products](/themes/kera/img/worn-still.webp "The toggle switches every card on the page at once.") ## Set it up 1. For every product, put the photo of the piece alone first and a worn photo second (Products > the product > Media). 2. In Theme settings > **Product cards**, set **First image** to **Worn** or **Still (product only)**. Installs as **Still (product only)**. 3. In **Collections** > **Default collection** > **Collection**, keep **Show worn and still toggle** on. :::note The toggle shows on a collection page only when at least one product on that page has a second photo. ::: ## Settings :::details Settings | Setting | What it does | | --- | --- | | **First image** | **Worn** shows each product's second image first. **Still (product only)** shows the first image. Installs as **Still (product only)**. In **Theme settings > Product cards**. Applies to every product grid that uses product cards. | | **Show worn and still toggle** | Shows the toggle in the collection's **Navigation bar**, next to Filter and sort (on phones, just above the products). In the Collection section. Installs on. | ::: ## Good to know :::details What does the toggle change? Every product card on the page switches at once, including cards loaded later with Load more or filters. The choice is saved in the shopper's browser and applies on every page and in other open tabs, until you change **First image**; then every shopper starts again from the new default. In the theme editor, cards always follow **First image**, so you see what new visitors see. ::: :::details Which photo shows on hover? With **Product images** set to **Second image on hover**, the hover image is the other one of the pair: the worn photo in Still, and the still photo in Worn. When a card opens on a variant that matches the filters in use, that variant's image is Still and the image after it is Worn. ::: :::details Can I show or hide the toggle on one collection? Yes, with the collection metafield `custom.view_toggle`. Create it as in [Metafields the theme reads](https://spellnsell.com/themes/kera/docs/store-data/metafields). On a collection, **True** shows the toggle even when **Show worn and still toggle** is off, **False** hides it, and empty leaves it to the section setting. ::: :::details Can one product have its own worn and still banner? Use **Switch hero**: see [Heroes and slideshows](https://spellnsell.com/themes/kera/docs/sections/heroes). ::: :::details The toggle doesn't show on a collection. No product on that page has a second image, **Show worn and still toggle** is off, or the collection's `custom.view_toggle` metafield is set to false. ::: --- # Add promo cards between products > Place image or video promo cards inside the collection grid, on every collection or only on the ones you choose. Source: https://spellnsell.com/themes/kera/docs/collections/promo-cards · Kera 1.0.0 · Updated 2026-11-14 **Where:** Online Store > Themes > Customize > Collections > Default collection > Collection > Add block > Promo image card Promo cards sit in the collection grid between products, with an image or a muted looping video, text and a button. Use them for an edit, a gift guide or an offer. ![A collection grid with two promo cards placed among the product cards](/themes/kera/img/promo-cards.webp "Cards can span one or two columns.") ## Set it up 1. Select the **Collection** section, click **Add block** and choose **Promo image card** or **Promo video card** (up to 6). The default template has one of each, at positions 3 and 7. 2. Set **Position in grid**: the card goes before that product. 3. Set **Width on desktop** and **Width on mobile**. 4. Add the **Image** or **Video**, then the **Heading**, **Button label** and **Link**. 5. To limit the card, pick collections in **Show on collections**. Empty shows it on every collection. :::note Cards show only on the first page of a collection, not on page 2 or on products added with Load more. ::: ## Settings :::details Promo card settings Both blocks share these settings, except the media ones noted. | Setting | What it does | | --- | --- | | **Show on collections** | The collections the card shows on. Empty shows it on every collection. | | **Position in grid** | The product the card goes before. 1 to 24, default 3. With fewer products, the card goes at the end. | | **Width on desktop** | 1 column or 2 columns (default). | | **Width on mobile** | 1 column or Full width (default). | | **Image** | Promo image card only. The card's image. | | **Mobile image** | Promo image card only. Shown on phones instead. | | **Video** | Promo video card only. Plays muted on a loop. | | **Mobile video** | Promo video card only. Played on phones instead. | | **Overlay opacity** | Darkens the media behind the text. 0 to 60%, default 20%. | | **Text on media** | Light (default) or Dark. | | **Color scheme** | Used as the background when the card has no media. Default scheme 2. | | **Eyebrow** | Small text above the heading. Default "The edit". | | **Heading** | The card's heading. | | **Heading size** | Heading 4, Heading 3 (default) or Heading 2. | | **Text** | A short paragraph. | | **Button label** | The button's text. Default "Discover". | | **Link** | Where the card goes. Without a button label, the whole card links here. | | **Content position** | Top left, Bottom left (default), Center or Bottom center. | ::: Every setting: [Collection reference](https://spellnsell.com/themes/kera/docs/reference/sections/main-collection). ## Good to know :::details Why doesn't my promo card show? Check that you're on the first page of the collection, that the card has an image, video or heading (a card with neither shows nothing), and that **Show on collections** is empty or includes this collection. ::: :::details How do cards affect the rows? Cards take grid space, so a 2-column card in a 4-column grid fills half a row. After placing a card, preview the page on desktop and on a phone to check the rows. ::: :::details Can I show a promo only on an editorial collection? Yes. Add it to the **Collection** section in that collection's template, or keep it in the default template and pick the collection in **Show on collections**. See [Editorial collections](https://spellnsell.com/themes/kera/docs/collections/editorial-collections). ::: --- # Build editorial collections > Turn a collection into an edit with a banner, chapters and guides above the grid, and list your edits on one page. Source: https://spellnsell.com/themes/kera/docs/collections/editorial-collections · Kera 1.0.0 · Updated 2026-11-14 **Where:** Online Store > Themes > Customize > Collections > edit An editorial collection tells a story before the grid: a large banner, chapters that pair a photo with a few pieces, short styling guides, then every piece. Kera ships two such templates, **edit** and **edit-alt**, plus **edits**, a page that lists them. ![An edit collection page: chapter tabs, a photo with a pinned product, and product cards beside it](/themes/kera/img/editorial-collections.webp "Chapter tabs stick under the header and mark the chapter in view.") ## Set it up 1. In Shopify admin, open the collection (**Products > Collections**) and set **Theme template** to **edit**. Save. 2. In the editor, choose **Collections** > **edit** from the page selector and preview it with your collection. 3. In **Collection banner**, set the **Image** and **Height**. 4. In **Editorial chapters**, fill each **Chapter** block (up to 6) with a **Chapter name**, **Heading**, **Image** and up to 4 **Products**. 5. Replace the example images, products and text in **Guides** and **Rich text**. :::note Every collection on a template shares its sections. For an edit with different chapters, use another template, or click **Create template** in the page selector, based on **edit**. ::: :::sidekick Open Sidekick in the Shopify admin and paste this, with your own names and numbers. Check what it fills in before you save. ```sidekick Set the theme template of the "Golden hour" collection to "edit". ``` ::: ## Settings :::details Collection banner | Setting | What it does | | --- | --- | | **Image** | Empty uses the collection's image. **Mobile image** is for phones. | | **Height** | **Small**, **Medium** (default), **Large** or **Full screen**. | | **Fade behind text** | Keeps text readable, with **Text color**. | | **Heading** | Empty uses the collection title. | | **Text** | Replaces the collection description. | | **Show product count in eyebrow** | Adds the count to the eyebrow. **Show lowest price in eyebrow** adds the price. | | **Collections** | Links to other collections under the banner. | ::: :::details Editorial chapters | Setting | What it does | | --- | --- | | **Chapter name** | Shows on the tab and above the heading. | | **Product** | Under **Pinned product**: a piece pinned on the photo. Tapping its dot shows it; its + opens quick view. | | **Show card open** | Shows the pinned card from the start. | | **First image** | The first photo's side; then they alternate. | | **Shop all link** | Where the bar's **Shop all** goes. Empty jumps to the grid below. | ::: :::details Guides | Setting | What it does | | --- | --- | | **Picture** | An **Image** or the **Necklace length diagram**. Up to 4 **Guide** blocks. | | **Heading** | The guide's title. | | **Link** | Where the guide links, with **Link label**. | The grid below is the regular **Collection** section with **Heading** set to **Shop the edit**: see [Collection page and filters](https://spellnsell.com/themes/kera/docs/collections/collection-page). ::: :::details Editorial list section settings | Setting | What it does | | --- | --- | | **Heading** | Uses the page title when empty. | | **Text** | Uses the page content when empty. | | **Show number of editorials** | Installs on. | | **Eyebrow** | The Coming next band's eyebrow. | | **Link label** | The Coming next band's link text. | | **Link** | Where the Coming next band links. | ::: :::details Editorial block settings | Setting | What it does | | --- | --- | | **Collection** | The edit. Its pieces, count and lowest price show under the photo. | | **Show large** | Full width, with four pieces named under it. | | **Eyebrow** | Small text above the heading. Default "The edit". | | **Heading** | Uses the collection title when empty. | | **Image** | Uses the collection's image when empty. | | **Link** | Uses the collection's page when empty. | | **Note under the photo** | Replaces the number of pieces and price. | ::: Every setting: [Collection banner reference](https://spellnsell.com/themes/kera/docs/reference/sections/collection-banner), [Editorial chapters reference](https://spellnsell.com/themes/kera/docs/reference/sections/edit-chapters), [Guides reference](https://spellnsell.com/themes/kera/docs/reference/sections/edit-guides), [Editorial list reference](https://spellnsell.com/themes/kera/docs/reference/sections/edits-index). ## Good to know :::details How do I list all my edits on one page? Create a page in **Online Store > Pages** with **Theme template** set to **edits**. In the page selector, choose **Pages** > **edits**, then select **Editorial list** and add an **Editorial** block per edit with its **Collection**. Clear the **Coming next** band's **Heading** to hide it. ::: :::details Can I add chapters to my regular collection template? Yes. **Editorial chapters** and **Guides** can be added to any template. The **Collection banner** works on any collection template, above the grid. ::: :::details Why doesn't the Shop all link show a count? **Add the product count to the label** adds the count only on a collection page, where there is a collection to count. ::: --- # Set up search and predictive search > Choose what search looks through, set up the search panel's popular searches and products, and the search results page. Source: https://spellnsell.com/themes/kera/docs/collections/search · Kera 1.0.0 · Updated 2026-11-15 **Where:** Online Store > Themes > Customize > Theme settings > Search Kera has two places to search: the panel that opens from the header, and the search results page. Both suggest results as the shopper types and look through the same content. ![The search results page "Results for "ring"" with product cards](/themes/kera/img/search.webp "Results show 24 per page, with filters and sorting.") ## Set it up 1. In Theme settings > **Search**, set **Search results** to what search looks through. Installs as **All content**. 2. In **Online Store > Navigation**, make a menu of popular searches. 3. Select **Header** > **Header**. Under **Search**, choose the **Popular searches menu** and a **Popular products collection**. 4. In the page selector choose **Search**, select **Search results**, and set the same two. :::note Collections only appear as suggestions. The search results page never lists collections. ::: ## Settings :::details Theme settings > Search | Setting | What it does | | --- | --- | | **Search results** | What the suggestions and the search page look through: All content (default: products, collections, pages and blog posts), Products only, Products and collections, Products, pages and articles, or Products and pages. | | **Hide the menu while searching** | Desktop only. Turn it off to fade the menu and open search beside it. Installs on. | | **Use the header's colors** | Installs on. The desktop search field keeps the header's colors either way. | | **Search color scheme** | The panel's colors when it doesn't use the header's. | ::: :::details Search results section settings | Setting | What it does | | --- | --- | | **Color scheme** | Colors of the section. | | **Show filters** | Installs on. | | **Show sorting** | Installs on. | | **Popular searches menu** | A menu shown before a search. | | **Popular searches heading** | Default "Popular searches". | | **Popular products collection** | Its first products show before a search. | | **Popular products heading** | Default "Popular products". | | **Products shown** | 2 to 8, default 4. | | **Top spacing** | None, Small, Medium (default) or Large. | | **Bottom spacing** | None, Small, Medium (default) or Large. | The **Header** section has the same popular searches and products settings for the header's panel, under **Search**. Leave a menu or collection empty to hide that part. ::: Every setting: [Search results reference](https://spellnsell.com/themes/kera/docs/reference/sections/main-search). ## Good to know :::details How much space is around the search panel? The same above and below the suggestions: 16px, matching the space the header leaves above and below the logo. ::: :::details What do suggestions show? A row of links (suggested terms, then matching collections, pages and articles; it scrolls sideways when too long), matching products as small cards, and a **View all** link. Each type shows up to 6 results. Arrow keys move through results, Escape clears the field, and Enter opens a result or searches. ::: :::details How does the results page look? The search field at the top, then results 24 per page with page numbers. Products show as product cards (Theme settings > Product cards); pages and articles show as cards in the same style, labeled with their type. Filters and sorting come from the **Search & Discovery** app, as on [Collection page and filters](https://spellnsell.com/themes/kera/docs/collections/collection-page). If filters leave no results, they stay so the shopper can take them off. ::: :::details The suggestions show collections, but the results page doesn't. That's expected: Shopify's search results page lists products, pages and articles only. With **Products and collections**, the page lists products only. ::: :::details A product doesn't show in search. Check that it's active and available on the Online Store sales channel. Shopify hides products whose `seo.hidden` metafield is set to `1`. ::: :::details How do I add synonyms or boost products? Use the **Search & Discovery** app. The theme shows the results Shopify returns. ::: --- # Set up the cart drawer and cart page > Choose between a cart drawer and a cart page, decide what happens after Add to bag, and set up the order note, discount codes and checkout options. Source: https://spellnsell.com/themes/kera/docs/cart/cart · Kera 1.0.0 · Updated 2026-11-14 **Where:** Online Store > Themes > Customize > Theme settings > Cart Kera calls the cart the bag. It opens as a drawer from the side of the screen or as its own page at `/cart`; both show the same lines, totals and blocks. ![The cart page with two items, the free shipping and gift progress bar, the free gift picker and the subtotal](/themes/kera/img/cart.webp "The drawer and the page share the same lines and totals.") ## Set it up 1. In Theme settings > **Cart**, set **Cart type** to **Drawer** or **Page**. Installs as **Drawer**. 2. Set **After adding to the bag**: **Open the bag** (installs this way), **Stay on the page**, **Go to the cart page** or **Go to checkout**. 3. Turn on the options you want, such as **Show order note** or **Show discount code field**. 4. Add blocks under the lines: in **Overlays** > **Cart drawer** for the drawer, and in the **Cart** page's **Cart** section for the page. :::note The drawer and the page have their own blocks. Add a block to both if you want it in both places. ::: ## Settings :::details Theme settings > Cart | Setting | What it does | | --- | --- | | **Cart type** | **Drawer** opens the **Cart drawer** section from the Overlays group. **Page** sends the header's bag icon to the cart page. Installs as **Drawer**. | | **After adding to the bag** | **Open the bag** (opens the cart page when **Cart type** is **Page**), **Stay on the page** (only the header's bag count updates), **Go to the cart page** or **Go to checkout**. Installs as **Open the bag**. | | **Show vendor** | The vendor above each line's name. Installs off. | | **Show savings** | A "You save" line adding compare-at savings and discounts. Installs on. | | **Show tax and shipping note** | A line under the subtotal, linked to your shipping policy when you have one. Installs on. | | **Show order note** | An **Order note** tab. The note is saved on the order. Installs on. | | **Show dynamic checkout buttons** | Shop Pay, Apple Pay, PayPal and other express buttons under Checkout. Installs on. | | **Show discount code field** | A **Discount code** tab. Installs off; shoppers then enter codes at checkout. | | **Require terms agreement** | A checkbox the shopper must tick before checkout. The order is marked "Terms accepted: Yes". Installs off. | | **Terms page** | Empty links to the store's terms of service. | | **Collections to shop** | Shown as a carousel when the bag is empty. | The order note and discount code are two tabs above the subtotal; one opens at a time. The progress bar and free gift settings are in the same group: [Free shipping bar and free gift](https://spellnsell.com/themes/kera/docs/cart/free-shipping-and-gift). ::: Every setting: [Cart drawer reference](https://spellnsell.com/themes/kera/docs/reference/sections/cart-drawer), [Cart reference](https://spellnsell.com/themes/kera/docs/reference/sections/main-cart). ## Good to know :::details Which adds follow "After adding to the bag"? Every add, including quick add, quick view and the jewelry tools, except adds from inside the bag, such as **Complete the look**. ::: :::details Which blocks can go under the lines? **Free gift** ([Free shipping bar and free gift](https://spellnsell.com/themes/kera/docs/cart/free-shipping-and-gift)), **Complete the look** ([Bag suggestions](https://spellnsell.com/themes/kera/docs/cart/suggestions)), **Custom Liquid**, and app blocks such as gift wrap. Selecting **Cart drawer** keeps the drawer open in the preview; choose **Cart** in the page selector to edit the page. ::: :::details How do discounts show in the bag? Shoppers can apply several codes, each a removable chip; a code that doesn't apply shows "SPRING can't be used with this bag." Automatic discounts show under the line they apply to, or above the subtotal for the whole order. ::: :::details Does the cart page exist when I use the drawer? Yes. It's always at `/cart`, built by the **Cart** section on the cart template. If you remove the **Cart drawer** section from Overlays while **Cart type** is **Drawer**, adding to the bag goes to the cart page instead. ::: :::details Can I change the word "bag"? Yes. Go to **Online Store > Themes** > **...** > **Edit default theme content** and search for "bag". ::: --- # Set up the free shipping bar and free gift > Show shoppers how far they are from free shipping and a free gift, let them pick the gift in the bag, and set up the shipping rate and discount that make both free. Source: https://spellnsell.com/themes/kera/docs/cart/free-shipping-and-gift · Kera 1.0.0 · Updated 2026-11-14 **Where:** Online Store > Themes > Customize > Theme settings > Cart > Progress bar One progress bar in the bag with up to two goals: free shipping and a free gift. At the gift goal, a picker appears and the shopper chooses one gift. ![The cart drawer: progress bar, two items, "Choose your free gift" with gift products, subtotal and Check out](/themes/kera/img/free-shipping-and-gift.webp "The gift picker appears once the bag reaches the gift goal.") ## Set it up 1. Create a collection holding only the gift products, for example "Gift with purchase". 2. In Theme settings > **Cart**, turn on **Show progress bar** and set **Free shipping from**. 3. Turn on **Free gift over an amount**, choose the **Gift collection** and set **Free gift from**. ## Create the rate and the discount 1. In **Settings > Shipping and delivery**, add a free rate based on order price, with the same minimum as **Free shipping from**. 2. In **Discounts > Create discount**, choose **Buy X get Y** and **Automatic discount**. 3. Under **Customer buys**, choose **Minimum purchase amount**: the same amount as **Free gift from**. 4. Under **Customer gets**, set quantity **1** from your gift collection, **Free**, with a maximum of **1** use per order. Save. :::warning The theme only shows the goals. Without the shipping rate and the discount, shoppers still pay for shipping and the gift. ::: :::sidekick Open Sidekick in the Shopify admin and paste this, with your own names and numbers. Check what it fills in before you save. ```sidekick Create a manual collection called "Gift with purchase" with only the product "Pearl studs". ``` ```sidekick Create an automatic Buy X get Y discount: when the order subtotal is €150 or more, the customer gets 1 product from the "Gift with purchase" collection free, at most once per order. ``` ```sidekick Walk me through adding a free shipping rate for orders of €150 or more in Shipping and delivery. ``` ::: ## Settings :::details Theme settings > Cart | Setting | What it does | | --- | --- | | **Show progress bar** | Shows the distance to free shipping and the free gift. Installs off. | | **Free shipping from** | The free shipping goal, in store currency. Default 150. | | **Free gift over an amount** | Turns on the free gift. Installs off. It shows nothing until a **Gift collection** with products is chosen. | | **Gift collection** | Its first 4 products, in the collection's sort order, show in the gift picker. Sold-out gifts are left out. | | **Free gift from** | The gift goal, in store currency. Default 250. | ::: :::details Free gift block | Setting | What it does | | --- | --- | | **Heading** | The picker's title. Empty shows "Choose your free gift", then "Your free gift" once a gift is in the bag. | ::: ## Good to know :::details How does the bar count? It shows the distance to free shipping ("You're €40 away from free shipping"), then to the gift, with an icon for each goal. It counts line prices after discounts, without the gift line. ::: :::details How does the gift picker behave? The shopper taps a gift to add it, or another to swap; the theme never adds one on its own. The gift shows its price crossed out and "Free", with no quantity control. The theme keeps one gift at quantity 1 and removes it if the bag drops below the goal. The picker comes from the **Free gift** block, installed in the **Cart drawer** (Overlays) and the **Cart** section; without it, the bar leaves out the gift goal. ::: :::details Which products should count toward the discount? Under **Customer buys** > **Any items from**, choose what counts, and leave the gift products out so Shopify counts the same amount as the bag. Keep gift products out of your other collections and hide them from search (see [Metafields](https://spellnsell.com/themes/kera/docs/store-data/metafields)). Then test in your store's preview: fill the bag to the goal, pick a gift, and check it's free at checkout. ::: :::details The bar doesn't show for some shoppers. The bag is empty, or the shopper pays in another currency: the goals are in your store currency and apply only there. For other markets, add Decimal definitions `custom.free_shipping_threshold` and `custom.free_gift_threshold` in **Settings > Metafields and metaobjects > Markets**, fill them in per market in its currency, and match its shipping rate and discount. They override the theme settings, which must still be turned on. ::: :::details Can I show only the free gift, without free shipping? Yes. Set **Free shipping from** to 0 and turn on **Show progress bar**; the bar then shows the gift goal only. With **Show progress bar** off, the picker still appears at **Free gift from**. ::: --- # Show suggestions in the bag > Use the Complete the look block to suggest up to three products in the cart drawer and cart page, chosen per product or from a collection. Source: https://spellnsell.com/themes/kera/docs/cart/suggestions · Kera 1.0.0 · Updated 2026-11-14 **Where:** Online Store > Themes > Customize > Overlays > Cart drawer > Complete the look The **Complete the look** block suggests up to 3 products under the lines in the bag. Shoppers add one with its + button without leaving the bag. ## Set it up 1. Select **Cart drawer** under **Overlays**; the drawer opens in the preview. The theme installs with a **Complete the look** block; if it's gone, click **Add block** > **Complete the look**. 2. Choose a **Collection** to fill the suggestions, for example your studs. 3. Do the same on the cart page: choose **Cart** in the page selector and select the **Cart** section. 4. Optional: pick suggestions per product with the `custom.cart_upsells` metafield. :::note Suggestions follow the item at the top of the bag, usually the one added last. ::: ## Settings :::details Complete the look block settings | Setting | What it does | | --- | --- | | **Collection** | Fills the suggestions after the item's `custom.cart_upsells` products. | | **Heading** | The title above the suggestions. Empty shows "Complete the look". | The block has the same settings in the cart drawer and on the cart page. Each place holds one; drag it above or below the **Free gift** block to change the order. ::: Every setting: [Cart drawer reference](https://spellnsell.com/themes/kera/docs/reference/sections/cart-drawer), [Cart reference](https://spellnsell.com/themes/kera/docs/reference/sections/main-cart). ## Good to know :::details Where do the suggestions come from? Up to 3 places are filled in order from the top item's `custom.cart_upsells` products, then the block's **Collection**, then the first collection that item belongs to. Products already in the bag, sold-out products and, while the free gift is on, the first 8 products of the gift collection are skipped. Gift lines are never the top item. An empty bag shows nothing. ::: :::details How do I choose suggestions for each product? Create the product metafield `custom.cart_upsells`, type **Product**, **List of products**: see [Metafields the theme reads](https://spellnsell.com/themes/kera/docs/store-data/metafields). On each product, pick its suggestions; the first 3 that can be bought are used. ::: :::details What happens when a shopper taps +? A product with one variant goes straight into the bag (tapping its photo works too), and the card shows **Undo** for a moment. A product with options opens in the quick view, which needs the **Quick view** section in Overlays; without it, the + goes to the product page. Products on the engraving template, gift cards and subscription products also open for a choice. The bag stays open, whatever **After adding to the bag** is set to. ::: :::details Why are no suggestions showing? All candidates are in the bag or sold out, or there's nothing to draw from: the top item has no `custom.cart_upsells` products, the block has no **Collection**, and the item isn't in any collection. ::: :::details Is this the same as Complete the stack on the product page? No. **Complete the stack** is a product page block with its own product list. See [Complete the stack and related products](https://spellnsell.com/themes/kera/docs/product-page/complete-the-stack). ::: --- # Journal and articles > Set up your blog page and article pages, with type tabs, reading time and products shown under each story. Source: https://spellnsell.com/themes/kera/docs/pages/journal · Kera 1.0.0 · Updated 2026-11-14 **Where:** Online Store > Themes > Customize > Blogs > Default blog Your blog shows as a journal: article cards with type tabs, and article pages with the products each story mentions. ![The Journal blog page with tag filters above a large featured article](/themes/kera/img/journal.webp "Each tab is an article tag.") ## Set it up 1. Write articles in **Online Store > Blog posts**. Tag each with its type, such as "Care". 2. In **Blogs > Default blog**, select **Blog** and replace the example **Types** with your tags, separated by commas. Empty uses every tag. 3. In **Blog posts > Default blog post**, pick your blog in the **Blog posts** section's **Blog** setting. 4. To show pieces under a story, pick **Products** in the **Shop the story** block, or leave it empty and fill the article's `custom.products` metafield. :::tip With **Feature the newest post** on, set **Posts per page** to 7, 10 or 13 to fill the rows evenly. ::: :::sidekick Open Sidekick in the theme editor and paste this, with your own names. Check the preview, then click **Save**. ```sidekick On the blog template, set the Blog section's Types to Care, Styling and Stories, and turn on Feature the newest post. ``` ::: ## Settings :::details Blog section settings | Setting | What it does | | --- | --- | | **Text** | A line under the title. | | **Posts per page** | 4 to 24, default 12. | | **Show story count** | Story count next to the title. Installs on. | | **Feature the newest post** | A large card for the newest story on page 1. Installs on. | | **Show type tabs** | Installs on. | | **Types** | Article tags to show as tabs, separated by commas. Empty uses all. | | **Show counts on the tabs** | Installs on. | | **Show sort** | Newest / Oldest control. Installs on. | | **Keep the tabs and sort in view** | Installs on. | | **Show type** | On each card. Installs on. | | **Show reading time** | On each card. Installs on. | | **Show date** | On each card. Installs off. | | **Show excerpt** | On each card. Installs on. | | **Card button label** | Default "Read the story". Leave blank to hide the button. | ::: :::details Blog post section settings | Setting | What it does | | --- | --- | | **Layout** | **Split** (default) keeps the image on the left while the story scrolls, from 990px wide. **Stacked** puts it above. | | **Side padding on desktop** | 16 to 80 px, default 40. Split layout only. | | **Show reading progress** | A line under the header that fills as the story is read. Installs on. | ::: :::details Blocks in the Blog post section **Title** (blog and type links, type, reading time, date, author, title, excerpt), **Featured image** (can carry the title and excerpt), **Content**, **Shop the story**, **Share** (with **Show tags**, the tags) and **Tags** (tags as links to the filtered blog). Reorder or remove any of them. ::: ## Good to know :::details Why are my type tabs empty or wrong? Tabs come from **Types**, which ships with four example types. Use your own tags, or clear it to use every tag. See [Product and article tags](https://spellnsell.com/themes/kera/docs/store-data/tags). ::: :::details Why don't the tab counts or featured post show? Counts come from the newest 50 posts, and are hidden on a type's page and on blogs with more than 50 posts. The featured post shows only on page 1 of the whole blog, not on a type's page or the Oldest sort. ::: :::details How is reading time worked out? From the article's integer metafield `custom.reading_time` when set. Otherwise words in the body divided by 200, minimum 1 minute. See [Metafields the theme reads](https://spellnsell.com/themes/kera/docs/store-data/metafields). ::: :::details How does Shop the story choose its products? Up to 4. Products picked in the block apply to every article on the template. With none picked, it reads each article's `custom.products` metafield (list of products). With neither, it shows nothing. ::: :::details My title shows twice. Why? The **Featured image** block puts the title on the photo. Turn off **Show title** in the **Title** block. ::: --- # Contact page and store locator > Build a contact page with ways to reach you, a contact form that emails you, a short FAQ and a map of your stores. Source: https://spellnsell.com/themes/kera/docs/pages/contact-and-store-locator · Kera 1.0.0 · Updated 2026-11-14 **Where:** Online Store > Themes > Customize > Pages > contact The **contact** template has four sections: **Contact header**, **Contact form**, **FAQ** and **Store locator**. Remove, reorder or reuse them on any page. For the **FAQ** section, see [FAQ page](https://spellnsell.com/themes/kera/docs/pages/faq). ![The store locator: a list of stores with opening hours and Directions links beside a map](/themes/kera/img/contact-and-store-locator.webp "Choosing a store moves the map.") ## Set it up 1. In **Online Store > Pages**, open or add the page and set **Theme template** to **contact**. 2. In **Contact header**, fill in **Label**, **Value** and **Note** on each **Contact card** (up to 3). 3. In **Contact form**, edit **Topics** (one per line) and **Note beside button**, and turn the order number and phone fields on or off. 4. In **Store locator**, add a **Store** block per store with **Store name**, **Street address**, **Postcode**, **City** and **Opening hours**, such as `10:00–19:00`. :::note Messages go to your store's contact email in **Settings > General**. Check spam if a test doesn't arrive. ::: ## Settings :::details Contact form settings | Setting | What it does | | --- | --- | | **Sticky side column** | The side column stays in view while the form scrolls. Installs on. | | **Form heading** | Default "Write to us". | | **Show topic field** | A topic list. Installs on. | | **Topics** | One per line. Empty hides the list. | | **Show order number field** | Installs on. | | **Order number hint** | A line under the field, such as where to find the number. | | **Show phone field** | Installs off. | | **Button label** | Default "Send message". | | **Note beside button** | Rich text next to the button, such as reply times and a privacy link. | ::: :::details Store locator settings | Setting | What it does | | --- | --- | | **Show search** | A search field over the list. Installs on. | | **Show city tabs** | Tabs per city when stores are in more than one city. Installs on. | | **Map zoom** | 3 to 20, default 15. Doesn't apply to a pasted map embed link. | | **Map height on desktop** | **Match the list**, **Medium**, **Large** (default) or **Screen height**. With a fixed height, a long list scrolls next to the map. | | **Label after the name** | For example "Stockist". | | **Image** | Shown in the card over the map on desktop. | | **Services** | Separated by commas, for example "Piercing, Engraving". | | **Phone** | Shown on the store card. | ::: ## Good to know :::details Where do the contact cards link? An email address in **Value** links to it; a phone number opens a call. To link elsewhere, such as a chat app, fill in **Link**. Leave **Heading** empty to use the page title. Breadcrumbs need **Show breadcrumbs** on in the section and in **Theme settings > Layout**. ::: :::details What does the form send? Name, email and message always. The topic and order number arrive under the labels in **Topic label** and **Order number label**. The side column takes **Side heading**, **Answer link**, **Detail row** (label and value) and **Note** blocks. ::: :::details The open or closed label doesn't show. Turn on **Show open or closed now**. The theme reads the first time range in **Opening hours**, such as `10:00–19:00` or `9am–6pm`; other text shows no label. Set **Time zone** (for example `America/New_York`) if the store isn't in your shop's time zone. ::: :::details How does "Use my location" work? Add **Latitude** and **Longitude** to stores. The button shows when at least one store has them, and sorts stores nearest first for shoppers who allow it. ::: :::details How does the map work? A Google Maps embed, no API key needed. It loads only as it nears the screen. The address places each store and builds its directions link. For a specific view, such as Street View, paste a Google Maps **Share > Embed a map** code or link in **Map embed link**. ::: --- # FAQ page > Build a questions page from FAQ sections, one per topic, with answers that open in place. Source: https://spellnsell.com/themes/kera/docs/pages/faq · Kera 1.0.0 · Updated 2026-11-14 **Where:** Online Store > Themes > Customize > Pages > faq The **faq** template shows the page title and content, then one **FAQ** section per topic. Each question opens in place. ![The FAQ page: question groups for Ordering and shipping and for Returns and repairs, with expandable questions](https://spellnsell.com/themes/kera/img/faq.webp) ## Set it up 1. In **Online Store > Pages**, open or add the page and set **Theme template** to **faq**. Its content shows above the questions. 2. Select an **FAQ** section and set its **Eyebrow** and **Heading**. 3. Select each **Question** block and type the **Question** and **Answer**. Use **Add block > Question** for more. 4. Delete topics you don't need, and add more with **Add section > FAQ**. :::note A question with an empty **Question** or **Answer** doesn't show on the store. ::: :::sidekick Open Sidekick in the theme editor and paste this, with your own names. Check the preview, then click **Save**. Read the answers it writes: they are about your store, so correct them before you save. ```sidekick On the faq page template, add an FAQ section with the heading "Care and repairs" and three Question blocks: how to clean silver, how to store pearls, and how repairs work. Write short answers I can edit. ``` ::: ## Settings :::details FAQ section settings | Setting | What it does | | --- | --- | | **Eyebrow** | A short line above the heading. Default "Questions". | | **Heading** | Default "Before you buy". | | **Heading size** | Extra large to Extra small. Default Extra small. | | **Layout** | **Centered** (default) puts the heading above. **Heading beside** puts it left on wide screens. | | **One answer open at a time** | Opening a question closes the open one. Installs off. | | **Top spacing** | None, Small, Medium or Large. | | **Bottom spacing** | None, Small, Medium or Large. | ::: :::details Question block settings | Setting | What it does | | --- | --- | | **Question** | The line shoppers click. | | **Answer** | Rich text: links, bold and lists. | | **Open by default** | Starts open. Installs off. | ::: :::details Page section settings | Setting | What it does | | --- | --- | | **Show page title** | Installs on. | | **Content width** | **Narrow** (default) or **Full**. | ::: ## Good to know :::details What comes in the template? Four FAQ sections with sample questions: orders and shipping, returns and repairs, materials and care, and sizing and gifts. Replace the samples with your own. ::: :::details Can I show questions on the product page? Yes. Add an **FAQ** section to the product template. The same questions show on every product using that template. ::: --- # Password page > Design the page visitors see while your store is password protected, with a message, a countdown and an email signup. Source: https://spellnsell.com/themes/kera/docs/pages/password · Kera 1.0.0 · Updated 2026-11-14 **Where:** Online Store > Themes > Customize > Others > Password While the store is password protected, visitors see this page instead. It has its own header with an **Enter using password** button, your message, an optional countdown and an email signup. ## Set it up 1. Turn on password protection and write the message in **Online Store > Preferences > Password protection**. 2. Select **Password page** and add an **Image** if you want one. 3. Edit the **Eyebrow**, **Heading** and **Text** blocks. With **Show the store's password message** on, the Text block shows your Preferences message when there is one. 4. Optional: add a **Countdown** block with **End date** (`YYYY-MM-DD`) and **End time** (`HH:MM`, 24-hour). 5. Keep the **Newsletter signup** block to collect emails. Signups become customers tagged `newsletter`. :::warning If you turn off **Show the "Enter using password" button**, add a **Password form** block to the Password page section, or visitors can't enter the password. ::: ## Settings :::details Password page section settings | Setting | What it does | | --- | --- | | **Image** | Optional. Beside the text on desktop, above it on phones. | | **Image position** | **Left** or **Right** (default). Shows when an image is set. | | **Text alignment** | **Centered** (default) or **Left**. Shows when no image is set. | | **Show wordmark** | Your store name, large, along the bottom. Hidden when an image is set. | | **Wordmark text** | Uses the store name when empty. | | **Show footer (social icons, powered by)** | A small line with the Powered by Shopify link and social icons. | ::: :::details Password page header settings | Setting | What it does | | --- | --- | | **Logo** | **Left** (default) or **Centered**. | | **Show the "Enter using password" button** | Opens the password dialog. Installs on. | | **Show a line under the header** | A hairline under the header. Installs on. | ::: ## Good to know :::details Why does the password do nothing in the editor? The editor stays on this page. Test in a private browser window. ::: :::details How is the page built? The header (**Announcement bar** and **Password page header**), the **Password page** section and the **Footer**. The header and footer are section groups for this page only, so changes there don't affect the rest of the store. ::: :::details How does the countdown work? It ends at the set moment in your store's time zone, the same for every visitor. Fill in **When finished** to show a message at the end; leave it empty to remove the countdown. ::: :::details Where do signups go? To **Customers** in Shopify admin, tagged `newsletter`. Use the tag to build a segment for your launch email. ::: :::details How do I take the store live? Turn off password protection in **Online Store > Preferences**. No theme change is needed. ::: --- # Customer accounts > Learn which account pages Kera styles, when Shopify hosts them instead, and where the account link appears in the header. Source: https://spellnsell.com/themes/kera/docs/pages/accounts · Kera 1.0.0 · Updated 2026-11-14 **Where:** Shopify admin > Settings > Customer accounts Customers sign in to see their orders and addresses. Which pages they see depends on the account type in **Settings > Customer accounts**. - **New customer accounts** (Shopify's default): sign-in with a one-time email code. Shopify hosts the pages, and you style them in Shopify admin. Kera's account templates aren't used. - **Classic customer accounts** (legacy): email and password sign-in on your store, using Kera's templates. ## Set it up 1. In **Settings > Customer accounts**, turn accounts on and choose the type. 2. For classic accounts, open the page selector at the top of the theme editor and choose an account page to edit. 3. To change the wording, use **Edit default theme content**. See [Translations and languages](https://spellnsell.com/themes/kera/docs/reference/translations). ## Good to know :::details Which pages are there for classic accounts? Each page has one section (**Color scheme**, **Top spacing**, **Bottom spacing**): | Section | What it shows | | --- | --- | | **Login** | Sign-in, a **Forgot your password?** form, and guest checkout when your checkout allows it. | | **Register** | First name, last name, email and password. | | **Account** | Orders (20 per page) with payment and fulfillment status, and the default address. | | **Order** | Items, discounts, shipping, taxes, totals, addresses and tracking links. | | **Addresses** | Saved addresses, with add, edit and delete (with confirmation). | | **Activate account** | Sets a password for an account you invited. | | **Reset password** | Sets a new password from the reset email. | ::: :::details Where does the account icon show? Next to the bag in the header, and as a **Log in** or **Account** link in the mobile menu. The header's **Customer account menu** picks the menu for signed-in customers. No icon means customer accounts are off in **Settings > Customer accounts**; turn them on and it appears. ::: :::details I changed the account pages, but customers don't see it. Your store probably uses new customer accounts, which Shopify hosts. Check **Settings > Customer accounts**. ::: :::details Can I add sections to the account pages? Yes, above or below the main section, as on other templates. Classic accounts only. ::: --- # Metafields the theme reads > Every metafield Kera reads, with its owner, key and type, how to create each definition, and how to connect your own metafields to blocks. Source: https://spellnsell.com/themes/kera/docs/store-data/metafields · Kera 1.0.0 · Updated 2026-11-15 **Where:** Shopify admin > Settings > Metafields and metaobjects Kera reads these metafields by name. All are optional. Use exactly this namespace, key and type. ## Set it up 1. In **Settings > Metafields and metaobjects**, choose **Products**, **Collections**, **Blog posts** or **Markets**. 2. Click **Add definition** and enter a name. 3. Click the namespace and key under the name and set it exactly, for example `custom.real_size`. 4. Choose the type from the table below, then save. Fill it in at the bottom of each item in the admin. | Owner | Namespace and key | Type | What uses it | | --- | --- | --- | --- | | Product | `custom.size_guide` | **Page** | The size guide opens this page first. | | Product | `custom.real_size` | **Single line text**, for example `24 mm` | A real-size label on cards with **Name inside the image**. | | Product | `custom.cart_upsells` | **Product**, **List of products** | **Complete the look** in the bag. Up to 3 are used. | | Product | `custom.size_previews` | **Metaobject**, **List of entries** (Size preview) | **Size comparison** with **Sizes** set to **Product metafield**: one worn photo per size. See [Size comparison](https://spellnsell.com/themes/kera/docs/jewelry-tools/size-comparison). | | Product | `reviews.rating` | **Rating** | Star ratings on product cards, the **Rating** block and structured data. Set by your reviews app; you don't need to create it. | | Product | `reviews.rating_count` | **Integer** | The review count after the stars. Set by your reviews app. | | Product | `seo.hidden` | **Integer**, value `1` | Hides a product from search and the **Gift finder**. Usually set by SEO apps; you don't need to create it. | | Collection | `custom.view_toggle` | **True or false** | Turns the Worn / Still toggle on or off. | | Collection | `custom.real_size` | **Single line text**, for example `12–30 mm` | A real-size label on collection cards. | | Article | `custom.reading_time` | **Integer** (minutes) | Reading time. | | Article | `custom.products` | **Product**, **List of products** | **Shop the story**. Up to 4 are used. | | Market | `custom.free_shipping_threshold` | **Decimal** | The market's free shipping goal, in its currency. | | Market | `custom.free_gift_threshold` | **Decimal** | The market's free gift goal, in its currency. | Amounts are in the currency's main unit: for 150 euros, enter `150`. If **Markets** isn't offered as an owner, use the amounts in **Theme settings > Cart**; they apply when customers pay in your store currency. :::sidekick Sidekick can't create metafield definitions yet, but it can walk you through them. In the Shopify admin, paste: ```sidekick Walk me through creating a product metafield definition with namespace and key custom.real_size, type Single line text, and show me how to fill it for many products at once. ``` ::: ## Good to know :::details What happens when a metafield is empty? | Namespace and key | When empty | | --- | --- | | `custom.size_guide` | A page named `size-guide-`, then the block's page, then **Size guide page** in **Theme settings > Drawers and overlays**. | | `custom.real_size` | Nothing shows. | | `custom.cart_upsells` | The block's collection, then the first item's first collection. | | `custom.size_previews` | **Size comparison** hides on that product's page. | | `reviews.rating` | No stars show. | | `reviews.rating_count` | The stars show without a count. | | `seo.hidden` | The product is included. | | `custom.view_toggle` | Shows when products have a second photo and **Show worn and still toggle** is on. | | `custom.reading_time` | Words ÷ 200, minimum 1. | | `custom.products` | Nothing shows. | | `custom.free_shipping_threshold` | **Free shipping from** in **Theme settings > Cart**, for store-currency customers only. | | `custom.free_gift_threshold` | **Free gift from** in **Theme settings > Cart**, for store-currency customers only. | ::: :::details How do I show a badge from my own metafield? Create a product metafield, for example `custom.badge`, then enter `namespace.key` in **Badge metafield** in **Theme settings > Badges** (installs empty). Set **Metafield badge position**, **Metafield badge style**, **Show on product page** and **Position on product page**. Supported types: - Single line or multi-line text: one badge. - Single line text, **List of values**: one badge per value, up to 3. - Metaobject, or a list up to 3: one badge per entry, from its `label` field (or `text`, or `title`). Optional `background_color`, `text_color` and `border_color` fields override **Metafield badge style**. See [Product cards and badges](https://spellnsell.com/themes/kera/docs/theme-settings/product-cards). ::: :::details How do I connect my own metafields to blocks? Use a dynamic source for details the theme doesn't read by name, such as metal or stone. Create and fill the definition, open the template in the theme editor, hover over a block setting and click **Connect dynamic source**. Only metafields whose type fits are listed. Settings made for this: | Block | Setting | Suggested metafield | | --- | --- | --- | | **Eyebrow** | **Text** | Single line text, such as `custom.material` | | **Text** | **Text** | Single line text, such as a subtitle | | **Collapsible row** | **Content** | Rich text or multi-line text, such as care instructions | | **Complete the stack** | **Products** | **Product**, **List of products**, such as `custom.stack` | The installed theme connects no dynamic sources. If a template points to a definition your store doesn't have, Shopify can't use that template, so create the definition first. ::: :::details I filled in the metafield, but nothing shows. Check the namespace and key in **Settings > Metafields and metaobjects**. A definition named "Real size" with the key `custom.realsize` isn't read. The key must match the table exactly. ::: :::details Can a metafield power a collection filter? Yes, through Shopify's Search & Discovery app, not the theme. See [Collection page and filters](https://spellnsell.com/themes/kera/docs/collections/collection-page). ::: --- # Product and article tags > The product tags that add New and Last pieces badges, how tags drive the gift finder and video reels, and how article tags become story types. Source: https://spellnsell.com/themes/kera/docs/store-data/tags · Kera 1.0.0 · Updated 2026-11-14 **Where:** Shopify admin > Products > a product > Tags Kera reads a few tags for badges and to match products and stories. ![A grid of product cards with Bestseller, Sale, Made to order, New and Last pieces badges](https://spellnsell.com/themes/kera/img/product-cards.webp) ## Badge tags | Tag | What it does | | --- | --- | | `new` | A **New** badge on product cards and in the product page **Eyebrow** block. | | `last-pieces` | A **Last pieces** badge on product cards and in the **Eyebrow** block. | Type them exactly, in lowercase. `New` or `last pieces` doesn't count. ## Other tags | Tag | Where | What it does | | --- | --- | --- | | Any product tag | **Gift finder** | Products with any tag in an answer's **Product tags** match that answer. Only the first 50 products of **Products from** are matched. See [Gift finder](https://spellnsell.com/themes/kera/docs/jewelry-tools/gift-finder). | | Any product tag | **Video reels** | Fills tabs with products whose tags, title or type match the tab name. | | Any article tag | **Blog** | Each tag is a story type, shown as a tab. | | `newsletter` | Customers | Added by the theme's email signup forms: the **Newsletter** section, the newsletter popup, the footer and the password page. | :::sidekick Open Sidekick in the Shopify admin and paste this, with your own names and numbers. Check what it fills in before you save. ```sidekick Add the tag new to every product created in the last 30 days. ``` ```sidekick Remove the tag new from every product created more than 60 days ago. ``` ::: ## Good to know :::details Which badge wins when several apply? A card shows one state badge, in this order: **Sold out** (no variant available), **Sale** (price below compare-at price), **New**, **Last pieces**. So a product tagged `new` that is on sale shows **Sale**. ::: :::details The New badge doesn't show. Check the tag is exactly `new`, **Show new and last pieces badges** is on in **Theme settings > Badges** (where the colors are too), and the product isn't on sale or sold out. The **Eyebrow** block needs **Show product badge** on. Change wording in [Translations and languages](https://spellnsell.com/themes/kera/docs/reference/translations). ::: :::details How do video reels match products? With **Fill empty tabs automatically** on, a tab with no video cards fills from the section's **Collection**. A product matches when the tab name appears as whole words in its title, product type or tags. Singular and plural both match: "Rings" matches "ring" and "Gold rings", but not "Earrings". ::: :::details How do article tags become story types? **Types** in the **Blog** section lists the tab tags; empty uses all. A card shows its first tag listed in **Types**, else its first tag (alphabetical). The article page's **Title** block shows the first tag. One type tag per article keeps it clear. See [Journal and articles](https://spellnsell.com/themes/kera/docs/pages/journal). ::: :::details Can I filter a collection by tag? Yes. Add a **Tag** filter in Shopify's Search & Discovery app. The theme shows it with the other filters. ::: --- # Labels in square brackets > Add small labels to menu links and product photos by typing them in square brackets, and keep a photo visible for every variant with #all. Source: https://spellnsell.com/themes/kera/docs/store-data/labels · Kera 1.0.0 · Updated 2026-11-14 **Where:** Shopify admin > Online Store > Navigation, or Products > a product > Media Type a label in square brackets, such as `Rings [New]`, and the theme shows it as a badge and removes it from the printed text. No app or metafield needed. | Where you type it | What shoppers see | | --- | --- | | A menu link called `Gifts [New]` | ![The Gifts menu link with a New badge beside it](https://spellnsell.com/themes/kera/img/preview-label-menu.webp) | | A photo's alt text ending in `[Bestseller]` | ![A product photo with a Bestseller badge in its top left corner](https://spellnsell.com/themes/kera/img/preview-label-photo.webp) | ## Set it up 1. **Menu link:** in **Online Store > Navigation**, open the menu and add the label to an item's name, for example `Rings [New]`. 2. **Product photo:** open the product, click a photo in **Media**, and add the label after the alt text, for example `Sculpted hoop, worn [Bestseller]`. 3. Save. More than one label works: `Rings [New] [Gift]`. :::note Photo labels show in the product page gallery only. Shopping feeds and apps that read alt text directly may still show the brackets. ::: ## Good to know :::details Where do menu labels show? In the header, mega menus, mega menu cards and the mobile menu. Where the plain name is needed, such as an "All Rings" link or an accessible label, the theme uses "Rings". ::: :::details Where do photo labels show? In a top corner of that photo in the product page gallery. Screen readers and search engines get the alt text without the label. Turn labels off with **Show labels from alt text** in the **Media gallery** block (installs on). ::: :::details How do I keep a photo for every variant? With **Selected variant photos only** on in the **Media gallery** block, 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, such as `Gift box #all`, to show it for every variant. The theme removes `#all` from the printed alt text. ::: :::details How do labels look? They use **Metafield badge style** (**Outline**, **Accent** or **Solid**) in **Theme settings > Badges**, and the badge shape and size. See [Product cards and badges](https://spellnsell.com/themes/kera/docs/theme-settings/product-cards). ::: :::details What are the exact rules? A label is the text between `[` and `]`, trimmed. A `[` without a closing `]` stays as typed. Empty `[]` shows nothing. Brackets elsewhere, such as in product titles, print as typed. ::: :::details Can I translate a label? Yes. In Translate & Adapt, translate the menu item or alt text and keep the brackets. See [Translations and languages](https://spellnsell.com/themes/kera/docs/reference/translations). ::: --- # Templates > The page templates Kera installs with and the sections each one starts with. Source: https://spellnsell.com/themes/kera/docs/reference/templates · Kera 1.0.0 · Updated 2026-11-16 **Where:** Online Store > Themes > Customize > the page selector at the top of the editor A template sets which sections a type of page starts with. Alternate templates (the part after the dot, such as `product.engraving`) are assigned per product, collection or page in the Shopify admin, under **Theme template**. | Template | Starts with | | --- | --- | | `404.json` | 404 page, Product tiles, Collection list | | `article.json` | Blog post, Blog posts | | `blog.json` | Blog, Newsletter | | `blog.oldest.json` | Blog | | `cart.json` | Cart | | `collection.edit.json` | Collection banner, Editorial chapters, Guides, Collection, Rich text | | `collection.golden-hour.json` | Collection banner, Editorial chapters, Guides, Collection, Rich text | | `collection.json` | Countdown, Collection, Gift finder | | `customers/account.json` | Account | | `customers/activate_account.json` | Activate account | | `customers/addresses.json` | Addresses | | `customers/login.json` | Login | | `customers/order.json` | Order | | `customers/register.json` | Register | | `customers/reset_password.json` | Reset password | | `gift_card.liquid` | Built in (Liquid template) | | `index.json` | Slideshow, Text reveal, Collection links, Featured collection, Image banner, Collection showcase, Collection tabs, Size comparison, Bundle builder, Logo list, Gift finder, Build a set, Personalization preview, Video carousel, Testimonials, Dial, Blog posts, Marquee | | `list-collections.json` | Collection tiles, Collection list page | | `page.about.json` | Image banner, Text reveal, Stats, Process index, Timeline, Quote with image, Portrait grid, Call to action band, Page | | `page.contact.json` | Contact header, Contact form, FAQ, Store locator | | `page.edits.json` | Editorial list, Lookbook carousel | | `page.faq.json` | Page, FAQ, FAQ, FAQ, FAQ | | `page.json` | Page | | `page.lookbook.json` | Lookbook, Shop by material | | `password.json` | Password page | | `product.engraving.json` | Product information, Sticky add to bag, Image banner, Services, FAQ, Apps, Related products, Recently viewed | | `product.json` | Product information, Sticky add to bag, Size comparison, Compare products, Portrait grid, Image with text, Video feature, Build a set, FAQ, Apps, Related products, Recently viewed | | `search.json` | Search results | --- # Translations and languages > Change the theme's built-in wording, translate your store into other languages, and show country and language selectors. Source: https://spellnsell.com/themes/kera/docs/reference/translations · Kera 1.0.0 · Updated 2026-11-14 **Where:** Online Store > Themes > ... > Edit default theme content Built-in wording such as "Add to bag" or "Sold out" comes from the theme's language file. Change it without code, and translate the store with Shopify's free Translate & Adapt app. Kera ships in English only, with no right-to-left layout. ## Change the theme's wording 1. In **Online Store > Themes**, click **...** on Kera, then **Edit default theme content**. 2. Search for the text, for example `Add to bag` or `Last pieces`. 3. Type the new wording and click **Save**. Keep placeholders such as `{{ count }}` as they are. :::note Text you typed into section and block settings isn't in this list. Change it in the theme editor. ::: ## Sell in more languages 1. Add a language in **Settings > Languages**. 2. Install **Translate & Adapt** and translate **Theme content** (built-in wording and your section text) and **Products**, **Collections**, **Pages**, **Blog posts**, **Navigation** and other content. 3. Publish the language in **Settings > Languages**. ## Country and language selectors | Where | Setting | | --- | --- | | **Footer** section | **Show country selector** and **Show language selector**. Both install on. | | **Header** section > **Mobile** block | **Show country and language**. Installs on. | ## Good to know :::details Why doesn't a selector show? A selector needs more than one choice: more than one country in **Settings > Markets**, or more than one published language in **Settings > Languages** (added isn't enough). With one of each, neither shows, whatever the settings. Each country shows its currency, for example "Canada (CAD $)". ::: :::details I changed a word, but the old text still shows. It probably comes from a section or block setting. Change it in the theme editor. ::: :::details Which files hold the text? `locales/en.default.json` holds the storefront text. `locales/en.default.schema.json` holds the theme editor labels. ::: :::details Do labels in square brackets work in translations? Yes. Keep the brackets in the translated text, such as `Rings [New]`. See [Labels in square brackets](https://spellnsell.com/themes/kera/docs/store-data/labels). ::: :::details Does the page language follow the shopper? Yes. The theme sets the page language to the one being browsed, so browsers and screen readers read it correctly. ::: --- # Accessibility > What Kera does for keyboard, screen reader and reduced-motion users, and what you need to add, such as alt text and readable colors. Source: https://spellnsell.com/themes/kera/docs/reference/accessibility · Kera 1.0.0 · Updated 2026-11-14 Kera works with a keyboard, a screen reader and reduced motion. Some of the work is yours: the theme can't write alt text or choose readable colors for you. Test your store with a keyboard and a screen reader. ## What you need to do 1. **Write alt text** for every photo: what matters to a shopper, such as "Gold hoop earrings, worn, close-up of the left ear". Skip "image of". 2. **Check colors** in **Theme settings > Colors**: text must stand out from its background, especially over photos. 3. **Keep text in text.** Put headings and offers in settings, not inside images. 4. **Label links** by where they go: "Shop rings", not "Shop now". ## Good to know :::details Where do I add alt text? Product photos: open the product, click the photo in **Media**, then **Add alt text**. Images in sections: select the image in the theme editor and use **Edit**, or set it in **Content > Files**. Collection and article images: on the image in the collection or blog post. A product photo without alt text uses the product title; an article card image uses the article title. ::: :::details What does the theme do for keyboard users? - A **Skip to content** link on the first Tab. - A focus ring on every link, button and field reached by keyboard (not on mouse clicks). - Drawers and dialogs (cart, quick view, filters, size guide, menus) keep focus inside while open. - Escape closes one thing at a time: a dropdown around the focus first, otherwise the top overlay. - Carousels are scrollable regions reached with Tab and scrolled with arrow keys; arrow buttons are real buttons. - FAQ questions and collapsible rows open with Enter or Space. ::: :::details What does the theme do for screen readers? - The page language follows the language being browsed. - Quick add, filter, search suggestion and store locator results are announced as they change. - Form errors are in text, not color alone. The contact form shows errors by each field and in a linked summary at the top. - Labels in square brackets are removed from alt text. ::: :::details What happens with reduced motion on? Wipes, zooms and slides become short fades, and other animations end at once. Slideshows don't advance on their own and the **Video feature** section shows its image instead of autoplaying. Marquee and logo list stand still. **Roll prices when they change** (**Theme settings > Animations**) turns off. Motion follows each shopper's device setting. The only switch for everyone is **Roll prices when they change**. ::: :::details Can shoppers pause moving content? Yes. The **Announcement bar** has a pause button with **Show pause button** on, and shows it on keyboard focus even when off. **Marquee** and **Logo list** have pause buttons. All three pause on hover and focus. The **Slideshow** shows a pause button when slides advance on their own or a video loops. ::: --- # Developer reference > The storefront events Kera fires, the cart actions it supports, the window.Kera functions custom code can call, and how the theme is built. Source: https://spellnsell.com/themes/kera/docs/reference/developer-events · Kera 1.0.0 · Updated 2026-11-14 For developers adding custom code or apps. Kera follows Shopify's [standard storefront events and actions](https://shopify.dev/docs/api/storefront-events-and-actions), so code written for that standard works unchanged. Events are bubbling DOM events named `shopify:*`, heard on `document`. Actions live on `window.Shopify.actions`. :::warning Code changes aren't covered by theme support or carried into new versions. Duplicate the theme first. See [Update the theme](https://spellnsell.com/themes/kera/docs/help/updating). ::: ## Events | Event | When | Dispatched on | | --- | --- | --- | | `shopify:page:view` | Every page load. | `document` | | `shopify:product:view` | A product page, quick view, Featured product section or product card is viewed. See the contexts below. | A hidden element inside the product or card | | `shopify:product:select` | An option changes on the product page, Featured product section or quick view. Resolves with the variant, or `null` when the combination doesn't exist. | The product's `` element | | `shopify:collection:view` | Collection page load. | A hidden element in the collection section | | `shopify:collection:update` | Filters or sort change. Resolves with `productsCount`. | The filter form | | `shopify:search:update` | Search page load with a query, and filter or sort changes. Resolves with `totalCount`. | The search section or the filter form | | `shopify:cart:view` | Cart page load (`context: 'page'`) and each cart drawer open (`'dialog'`). | A hidden element in the cart section or drawer | | `shopify:cart:lines-update` | Any add, quantity change or removal through the theme. `action`: `add`, `update` or `remove`. `context`: `cart` in the bag (including suggestions and the free gift), `dialog` in quick view, `product` elsewhere. | The cart drawer, or the cart page section | | `shopify:cart:note-update` | The order note is saved. | Same as above | | `shopify:cart:discount-update` | A discount code is applied or removed. A code that doesn't apply resolves with `userErrors`. | Same as above | | `shopify:cart:error` | A cart request failed. | Same as above | `shopify:product:view` contexts: | Where | `context` | When | | --- | --- | --- | | Product page | `page` | Page load | | Quick view | `dialog` | Each open | | Featured product section | `page` | Once, when half on screen | | Product card on the search page | `search` | Once, when half on screen | | Product card on product and cart pages | `recommendation` | Once, when half on screen | | Any other product card | `collection` | Once, when half on screen | ## Actions | Action | What the theme does | | --- | --- | | `updateCart` | Shopify's default update, then redraws the bag and the header count. | | `openCart` | Opens the cart drawer, or goes to the cart page when **Cart type** is **Page**. Does nothing on the cart page. | ## Functions on window.Kera | Function | What it does | | --- | --- | | `Kera.refreshCart()` | Redraws the bag and header count from the current cart. Returns a promise. | | `Kera.openCart()` | Same as the `openCart` action. | | `Kera.openDrawer()` / `Kera.closeDrawer()` | Opens or closes the cart drawer when it is on the page. | | `Kera.addToCart(body)` | Adds items in Ajax API format (`{ items: [{ id, quantity, properties }] }`), redraws the bag, fires `shopify:cart:lines-update` and follows **After adding to the bag** (**Theme settings > Cart**). Rejects with the cart's error message. | | `Kera.openQuickView(url, trigger)` / `Kera.closeQuickView()` | Opens quick view for a product URL, returning focus to `trigger` on close; or closes it. Without the **Quick view** section in Overlays, opening goes to the product page. | | `Kera.subscribe(topic, handler)` | Calls `handler(payload)` for each theme message on `topic` (see below). Returns a function that unsubscribes. | | `Kera.formatMoney(cents)` | Formats an amount in cents with the store's money format, for example `formatMoney(15000)`. | | `Kera.fetchSections(ids, url)` | Renders the section IDs (an array) for `url` (default: the current page) with the Section Rendering API. Resolves with `{ id: html }`. | | `Kera.routes`, `Kera.strings`, `Kera.template`, `Kera.moneyFormat`, `Kera.cartType` | Read-only values: Shopify routes, a few translated strings, the template name, the store's money format and **Cart type**. | Topics for `Kera.subscribe`: | Topic | When | Payload | | --- | --- | --- | | `cart:update` | The bag changed through the theme. | The Ajax API cart object | | `cart:error` | An add failed. | The Ajax API error (`status`, `message`, `description`) | | `drawer:open` | The cart drawer or quick view opens. | `'cart'` or `'quick-view'` | | `drawer:close` | The cart drawer closes. | `'cart'` | | `variant:change` | A product form's variant changes. | `{ variant, sectionId }` | | `variant:media` | A variant change moves the gallery to its photo. | `{ mediaId, sectionId }` | ## Good to know :::details How do I listen to an event? Event data is on the event object. Most events carry a `promise` that settles once the change is complete; wait for it before reading the result. ```js document.addEventListener('shopify:cart:lines-update', async (event) => { const { action, context, lines } = event; const { cart, userErrors } = await event.promise; if (userErrors?.length) return; // Shopify declined the change, for example sold out console.log(`${action} from ${context}: the bag now holds ${cart.totalQuantity}`); }); ``` A change the cart declines (sold out, over a quantity limit) resolves with `userErrors` and `cart: null`. A request that fails (network down, server error) fires `shopify:cart:error` with `code: 'SERVICE_UNAVAILABLE'`, and the promise rejects. ::: :::details How do I update the cart with an action? ```js const { cart, userErrors } = await Shopify.actions.updateCart({ lines: [{ merchandiseId: 'gid://shopify/ProductVariant/123456789', quantity: 1 }], }); if (!userErrors?.length) Shopify.actions.openCart(); ``` ::: :::details My code uses the Ajax cart API. How do I redraw the bag? Call `Kera.refreshCart()` after `/cart/add.js` or `/cart/change.js`. The functions exist once the theme's scripts load, so check first, for example `window.Kera?.refreshCart?.()`. ```js await fetch('/cart/add.js', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ items: [{ id: 123456789, quantity: 1 }] }), }); await window.Kera.refreshCart(); window.Kera.openCart(); ``` ::: :::details Where does the event data come from? View events use Liquid's `standard_event_data` filter. Cart events are built from the Ajax cart response. Shopify's event library loads from `cdn.shopify.com/storefront/standard-events.js`; if it can't load, the theme works but fires none of these events. The product form also fires `cart:added` on the `
` after a successful add, with no data, for older custom code. Use `shopify:cart:lines-update` instead. The theme listens to the editor's `shopify:section:*` and `shopify:block:*` events but doesn't fire them. ::: :::details How is the theme built? - **Blocks are private.** All files in `blocks/` start with `_`, so each block belongs to its section. Only these sections accept `@theme` blocks: `main-product`, `featured-product`, `main-article`, `image-with-text` and `rich-text`. `@app` blocks: `main-product`, `featured-product`, `main-cart`, `cart-drawer` and `apps`. - **CSS variables** are set on `:root` in `snippets/css-variables.liquid`: colors (`--color-background`, `--color-text`, `--color-accent`, `--color-button`, `--color-border`), type (`--font-heading`, `--font-body`, `--size-h1` … `--size-body`), spacing (`--space-1` … `--space-9`, `--section-space`, `--page-margin`, `--page-max-width`) and `--radius`. - **Color schemes** are classes: `.color-scheme-1` and so on, from each scheme's ID. `.color-mobile-` and `.color-desktop-` apply a scheme on phones or from 750px only. | File | What it holds | | --- | --- | | `assets/standard-events.js` | Page view, view events and the search page load event. | | `assets/cart.js` | Cart events and the `window.Kera` cart functions. | | `assets/product.js` | Option changes (`shopify:product:select`). | | `assets/facets.js` | Filter and sort changes. | | `assets/product-card.js` | Card and Featured product views. | | `layout/theme.liquid` | The `updateCart` and `openCart` action setup, before `content_for_header`. | | `snippets/import-map.liquid` | Maps Shopify's event library. | ::: --- # 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. ::: --- # Update the theme > Install a new version of Kera without losing your settings, and keep track of code changes that don't carry over. Source: https://spellnsell.com/themes/kera/docs/help/updating · Kera 1.0.0 · Updated 2026-11-14 **Where:** Online Store > Themes Updating adds a new copy of Kera to your theme library with your settings and content. Your live store doesn't change until you publish it. ## Update Kera 1. Read the [release notes](https://spellnsell.com/themes/kera/docs/help/release-notes), and list any code changes you or a developer made. 2. In **Online Store > Themes**, click the update notice on Kera and add the new version to your library. 3. Click **Customize** on the new version and check the home page, a product, a collection, the cart and any page with custom sections. 4. Publish when ready. The previous version stays in your library until you delete it. :::warning Code edits don't carry over. ::: ## Good to know :::details What carries over? | Carries over | Doesn't carry over | | --- | --- | | Theme settings, such as colors, typography and cart settings | Edits to Liquid, CSS and JavaScript files | | Sections, blocks and their settings on every template | Files you added to the theme's code | | Templates you created in the editor | Changes to the theme's language files made in the code editor | | Your store data: products, collections, pages, blog posts, menus, metafields and tags | | Store data never lives in the theme, so updating doesn't touch it. ::: :::details How do I customize without losing changes? Use settings, which carry over: section, block and theme settings; a **Custom Liquid** section, or a **Custom Liquid** block on the product page, Featured product section, cart drawer or cart page; app blocks; **Edit default theme content** for wording (see [Translations and languages](https://spellnsell.com/themes/kera/docs/reference/translations)); and **Connect dynamic source** for metafields (see [Metafields the theme reads](https://spellnsell.com/themes/kera/docs/store-data/metafields)). If you must change code, keep a list of every file and change. ::: :::details How do I edit theme code safely? Duplicate the theme first (**Online Store > Themes > ... > Duplicate**), edit the copy, preview it, and publish only when it works. Code changes aren't covered by [support](https://spellnsell.com/themes/kera/support). For custom work, hire a developer from the Shopify Partner Directory. Developers can hook into the [Developer reference](https://spellnsell.com/themes/kera/docs/reference/developer-events) without editing theme files. ::: :::details I installed Kera from a zip file. There's no update notice in the admin. Upload the new version's zip as a new theme, then set it up again in the editor, or ask a developer to copy your settings across. ::: :::details I don't see an update notice. You may have the latest version. Compare the version shown on Kera in **Online Store > Themes** with the release notes. ::: --- # Release notes > What each version of Kera adds and fixes, starting with the first release, 1.0.0. Source: https://spellnsell.com/themes/kera/docs/help/release-notes · Kera 1.0.0 · Updated 2026-11-16 Every version of Kera, newest first. To install one, see [Update the theme](https://spellnsell.com/themes/kera/docs/help/updating). ## 1.0.0 — November 2026 First release: a theme for fine jewelry stores, with more than 50 sections, a journal, jewelry tools and a cart drawer with a free shipping bar. Limits: English only; no right-to-left languages. :::details Product page - **Media gallery** in five layouts: Two columns, One column, Editorial, Thumbnails and Slideshow. Images, videos and 3D models, with a full-screen viewer. See [Media gallery and full-screen viewer](https://spellnsell.com/themes/kera/docs/product-page/media-gallery). - Photo labels from alt text, and a setting to show only the selected variant's photos. - Videos uploaded to Shopify play muted on a loop, with a pause button, and fade back into their first frame at each loop (**Play videos automatically**). A video placed first in the media leads the gallery for every variant. Product cards play a video that is the product's first media while the card is on screen, and one that is the second media while the card is hovered (**Play videos** in Product cards). - **Variant picker** styles: Buttons, Color circles, Squares, Variant images, Variant tiles and Dropdown. Size help with a size guide in a side drawer. - Size guides per product, product type or store. See [Size guides](https://spellnsell.com/themes/kera/docs/product-page/size-guides). - **Engraving** block with a live preview, saved on the order line. No app needed. - **Optional extra** block for extras such as gift wrapping, free or paid. - **Complete the stack**, **Related products**, **Recently viewed** and **Sticky add to bag**. - **Drop a hint**: shoppers send a link to the piece, with a greeting and their message, by WhatsApp, Viber or their device's share menu. Nothing is sent to the store. See [Drop a hint](https://spellnsell.com/themes/kera/docs/product-page/drop-a-hint). - A `product.engraving` template with the Engraving block and two Add-on blocks. - **Pickup availability**: where a location offers pickup, the time it's usually ready, and **Store details** that open the address. With several pickup locations it reads **Check other locations**. ::: :::details Jewelry tools - **Size comparison**: the piece worn at each size, with sizes in millimeters. Sizes come from the section's blocks or from each product's Size previews metafield, and on the product page they follow the size chosen in the buy box. See [Size comparison](https://spellnsell.com/themes/kera/docs/jewelry-tools/size-comparison). - **Bundle builder** (ear stack), **Charm builder**, **Build a set** and **Gift finder**. - **Compare products**, with a true-size row. - **Personalization preview**: an engraving studio for one product, placed on the product photo. ::: :::details Collections and search - Filters and sorting from Shopify's Search & Discovery app, with a bottom sheet on phones. - Worn / Still toggle between the worn photo and the product photo. - Editorial collection templates (`collection.edit` and `collection.edit-alt`) with chapters and guides above the grid. - Promo cards, with an image or a video, in the collection grid. - Predictive search, and a search page with popular searches and products. ::: :::details Header, menus and cart - Mega menus as columns, cards or a compact list. A mobile menu with collection images or your own cards. - Labels in square brackets on menu links, such as `Rings [New]`. - Country and language selectors, and a transparent header over the first section of the home and about pages. - Cart drawer or cart page, with a free shipping progress bar, an optional free gift, **Complete the look**, discount codes and an order note. The progress bar and free gift start turned off. ::: :::details Pages and storytelling - Sections including **Slideshow**, **Switch hero**, **Lookbook**, **Video reels**, **Testimonials**, **Timeline**, **Stats**, **Store locator** and **FAQ**. - Templates for about, contact, FAQ, edits and lookbook pages. - A journal with type tabs, Newest and Oldest sort, reading time and products in each story. See [Journal and articles](https://spellnsell.com/themes/kera/docs/pages/journal). - A password page with a countdown and email signup. ::: :::details Design, accessibility and developers - Four color schemes, picked per section with **Color scheme**. - Heading and body fonts with adjustable sizes. - Three section spacing steps (Small, Medium, Large), the same in every section. - Keyboard navigation with visible focus and a skip link. Reduced motion, and pause buttons for moving content. See [Accessibility](https://spellnsell.com/themes/kera/docs/reference/accessibility). - Ready for AI agents: structured data for every product and article, an address for every variant, filter and search, and named controls that assistants can use. See [Ready for AI agents](https://spellnsell.com/themes/kera/docs/get-started/ai-agents). :::