# Kera Shopify theme documentation > Merchant documentation for Kera 1.0.0, a Shopify Online Store 2.0 theme for fine jewelry stores by Spell & Sell. Each page answers one setup question and names settings exactly as the Shopify theme editor shows them. Every page is available as Markdown at its address plus .md. Notes for assistants: - Click paths start from the Shopify admin and are given on each page as a Where line. - Setting and block names in bold match the theme editor exactly. - Setting IDs, types and defaults for every section and block: https://spellnsell.com/themes/kera/reference/sections.json - Support for merchants: https://spellnsell.com/themes/kera/support ## Get started - [Install and first steps](https://spellnsell.com/themes/kera/docs/get-started/install.md): Add Kera to your theme library, preview it, and set up the logo, colors, menus, home page and product page before you publish. - [What the theme installs with](https://spellnsell.com/themes/kera/docs/get-started/whats-included.md): The style, templates, section groups and sample content Kera has when you add it to your store, and what you need to fill in. - [How the editor is organized](https://spellnsell.com/themes/kera/docs/get-started/editor-basics.md): Where Kera's templates, section groups, sections, blocks and theme settings sit in the Shopify theme editor, and how to add and arrange them. - [Set up Kera with an AI assistant](https://spellnsell.com/themes/kera/docs/get-started/ai-assistants.md): Point Claude, ChatGPT or another assistant at the Kera docs so it answers from the real settings, and work with it safely. - [Ready for AI agents](https://spellnsell.com/themes/kera/docs/get-started/ai-agents.md): 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. ## Theme settings - [Colors and color schemes](https://spellnsell.com/themes/kera/docs/theme-settings/colors.md): Edit Kera's four color schemes, pick a scheme per section, and set the sale price and stock message colors. - [Typography](https://spellnsell.com/themes/kera/docs/theme-settings/typography.md): Choose Kera's heading and body fonts, scale their sizes, and set labels in uppercase or sentence case. - [Layout, buttons and spacing](https://spellnsell.com/themes/kera/docs/theme-settings/layout-and-buttons.md): Set Kera's page margins, section spacing, breadcrumbs, carousel arrows, button hover and price, corner shapes and motion. - [Product cards and badges](https://spellnsell.com/themes/kera/docs/theme-settings/product-cards.md): Set how every product card in Kera looks, which photos it shows, its color swatches, and its Sale, Sold out, New and metafield badges. - [Quick add and quick view](https://spellnsell.com/themes/kera/docs/theme-settings/quick-add.md): 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. - [Drawers and overlays](https://spellnsell.com/themes/kera/docs/theme-settings/drawers-and-search.md): Set the colors of Kera's product and filter drawers, how the page looks behind them, and the store-wide size guide page. ## Header and footer - [Header layouts and sticky header](https://spellnsell.com/themes/kera/docs/header-footer/header.md): 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. - [Mega menus](https://spellnsell.com/themes/kera/docs/header-footer/mega-menus.md): Style the desktop panel of a top-level menu item in Kera with columns, collection images, product previews or your own image cards. - [Mobile menu](https://spellnsell.com/themes/kera/docs/header-footer/mobile-menu.md): 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. - [Announcement bar](https://spellnsell.com/themes/kera/docs/header-footer/announcement-bar.md): Show short messages or a countdown above Kera's header, as a scrolling ticker, one message at a time, or all at once. - [Footer](https://spellnsell.com/themes/kera/docs/header-footer/footer.md): Set up Kera's footer with newsletter, menu and text columns, selectors, social and payment icons, policy links and the large wordmark. ## Home and storytelling - [Heroes and slideshows](https://spellnsell.com/themes/kera/docs/sections/heroes.md): 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. - [Collection and product sections](https://spellnsell.com/themes/kera/docs/sections/collections-and-products.md): Add sections that lead shoppers to your collections and products, and set each one up in a few steps. - [Editorial sections](https://spellnsell.com/themes/kera/docs/sections/editorial.md): Add text, image and story sections for About pages, brand stories and promotions, and set each one up in a few steps. - [Video sections](https://spellnsell.com/themes/kera/docs/sections/video.md): Add Video carousel, Video reels or Video feature to a page, and set each one up in a few steps. - [Lookbook](https://spellnsell.com/themes/kera/docs/sections/lookbook.md): Build a shoppable lookbook page where each look adds its pieces to the bag, and link to it from a carousel of looks. - [Newsletter, popup and reviews](https://spellnsell.com/themes/kera/docs/sections/newsletter-and-reviews.md): Collect email sign-ups with a newsletter band or popup, show customer quotes, and add an image grid that links to your social profile. ## Product page - [Media gallery and full-screen viewer](https://spellnsell.com/themes/kera/docs/product-page/media-gallery.md): 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. - [Variant picker and size help](https://spellnsell.com/themes/kera/docs/product-page/variant-picker.md): 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. - [Size guides](https://spellnsell.com/themes/kera/docs/product-page/size-guides.md): Write size guide pages, decide which page each product opens, and show the guide in a side drawer from the product page. - [Engraving and add-ons](https://spellnsell.com/themes/kera/docs/product-page/engraving-and-add-ons.md): 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. - [Complete the stack and related products](https://spellnsell.com/themes/kera/docs/product-page/complete-the-stack.md): 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. - [Sticky Add to bag](https://spellnsell.com/themes/kera/docs/product-page/sticky-add-to-bag.md): 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. - [Drop a hint](https://spellnsell.com/themes/kera/docs/product-page/drop-a-hint.md): Let shoppers send a link to the piece they want, with a short message, by WhatsApp, Viber or their device's share menu. ## Jewelry tools - [Show sizes side by side with Size comparison](https://spellnsell.com/themes/kera/docs/jewelry-tools/size-comparison.md): Add a section where shoppers slide between sizes in millimeters and see each size worn, with the matching product under it. - [Ear stack builder](https://spellnsell.com/themes/kera/docs/jewelry-tools/ear-stack.md): 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. - [Charm builder](https://spellnsell.com/themes/kera/docs/jewelry-tools/charm-builder.md): Add the Add-on builder section so shoppers pick a bracelet or chain plus charms and add them to the bag together. - [Build a set and its discount](https://spellnsell.com/themes/kera/docs/jewelry-tools/build-a-set.md): Add the Build a set section and create the matching automatic discount so a complete set is charged at the price the section shows. - [Set up the gift finder](https://spellnsell.com/themes/kera/docs/jewelry-tools/gift-finder.md): Add the Gift finder section, write its questions and answers, and tag products so shoppers get the pieces that fit their answers. - [Set up the engraving studio](https://spellnsell.com/themes/kera/docs/jewelry-tools/engraving-studio.md): Use the Personalization preview section for a live engraving preview, and the engraving product template for pieces that take an engraving. - [Compare products](https://spellnsell.com/themes/kera/docs/jewelry-tools/compare-products.md): 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. ## Collections and search - [Set up the collection page and filters](https://spellnsell.com/themes/kera/docs/collections/collection-page.md): Lay out the collection grid, add filters from Search & Discovery, and set up sorting, pagination and the sticky navigation bar. - [Use the Worn / Still toggle](https://spellnsell.com/themes/kera/docs/collections/worn-still.md): Choose whether product cards show pieces worn or on their own, let shoppers switch, and control the toggle per collection. - [Add promo cards between products](https://spellnsell.com/themes/kera/docs/collections/promo-cards.md): Place image or video promo cards inside the collection grid, on every collection or only on the ones you choose. - [Build editorial collections](https://spellnsell.com/themes/kera/docs/collections/editorial-collections.md): Turn a collection into an edit with a banner, chapters and guides above the grid, and list your edits on one page. - [Set up search and predictive search](https://spellnsell.com/themes/kera/docs/collections/search.md): Choose what search looks through, set up the search panel's popular searches and products, and the search results page. ## Cart - [Set up the cart drawer and cart page](https://spellnsell.com/themes/kera/docs/cart/cart.md): 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. - [Set up the free shipping bar and free gift](https://spellnsell.com/themes/kera/docs/cart/free-shipping-and-gift.md): 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. - [Show suggestions in the bag](https://spellnsell.com/themes/kera/docs/cart/suggestions.md): 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. ## Pages, blog and accounts - [Journal and articles](https://spellnsell.com/themes/kera/docs/pages/journal.md): Set up your blog page and article pages, with type tabs, reading time and products shown under each story. - [Contact page and store locator](https://spellnsell.com/themes/kera/docs/pages/contact-and-store-locator.md): Build a contact page with ways to reach you, a contact form that emails you, a short FAQ and a map of your stores. - [FAQ page](https://spellnsell.com/themes/kera/docs/pages/faq.md): Build a questions page from FAQ sections, one per topic, with answers that open in place. - [Password page](https://spellnsell.com/themes/kera/docs/pages/password.md): Design the page visitors see while your store is password protected, with a message, a countdown and an email signup. - [Customer accounts](https://spellnsell.com/themes/kera/docs/pages/accounts.md): Learn which account pages Kera styles, when Shopify hosts them instead, and where the account link appears in the header. ## Store data - [Metafields the theme reads](https://spellnsell.com/themes/kera/docs/store-data/metafields.md): Every metafield Kera reads, with its owner, key and type, how to create each definition, and how to connect your own metafields to blocks. - [Product and article tags](https://spellnsell.com/themes/kera/docs/store-data/tags.md): 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. - [Labels in square brackets](https://spellnsell.com/themes/kera/docs/store-data/labels.md): 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. ## Reference - [Sections A to Z](https://spellnsell.com/themes/kera/docs/reference/sections.md): Every section in Kera with what it does, where it can go and a link to its full list of settings and blocks. - [Every theme setting](https://spellnsell.com/themes/kera/docs/reference/settings.md): All theme settings in Kera, grouped as the editor shows them, with types, defaults and what each one does. - [Templates](https://spellnsell.com/themes/kera/docs/reference/templates.md): The page templates Kera installs with and the sections each one starts with. - [Translations and languages](https://spellnsell.com/themes/kera/docs/reference/translations.md): Change the theme's built-in wording, translate your store into other languages, and show country and language selectors. - [Accessibility](https://spellnsell.com/themes/kera/docs/reference/accessibility.md): What Kera does for keyboard, screen reader and reduced-motion users, and what you need to add, such as alt text and readable colors. - [Developer reference](https://spellnsell.com/themes/kera/docs/reference/developer-events.md): The storefront events Kera fires, the cart actions it supports, the window.Kera functions custom code can call, and how the theme is built. ## Help - [Troubleshooting and questions](https://spellnsell.com/themes/kera/docs/help/troubleshooting.md): Answers to common Kera questions, from missing filters and checkout buttons to free gifts, badges, headers and custom code. - [Update the theme](https://spellnsell.com/themes/kera/docs/help/updating.md): Install a new version of Kera without losing your settings, and keep track of code changes that don't carry over. - [Release notes](https://spellnsell.com/themes/kera/docs/help/release-notes.md): What each version of Kera adds and fixes, starting with the first release, 1.0.0. ## Optional - [All guides in one file](https://spellnsell.com/themes/kera/llms-full.txt): every guide above, concatenated - [Section reference pages](https://spellnsell.com/themes/kera/docs/reference/sections.md): one page per section with every setting and block - [Theme settings as JSON](https://spellnsell.com/themes/kera/reference/settings.json) - [Metafields as JSON](https://spellnsell.com/themes/kera/reference/metafields.json)