Kaolin Theme documentation
Version 1.0.0  ·  Shopify Online Store 2.0

Kaolin

An editorial theme for furniture, objects and wardrobe. This page covers installation, every theme setting, the section library, and what each template ships with.

Theme type
Online Store 2.0
Sections
13 storefront sections
Requires
No app

1Installing Kaolin

  1. In the Shopify admin, open Online Store > Themes > Add theme > Upload zip file and upload the Kaolin package.
  2. When the upload finishes, open Customize to set your logo, fonts and colors, then publish the theme.
  3. Check the navigation menus Kaolin expects: a Main menu (two levels render best) and a Footer menu. Both exist in a new store already.
  4. Choose a collection for the featured collection section, and pick images for the opening spread, lookbook and editorial sections.
  5. Add your social profiles under Theme settings > Social so the footer icons appear.

Kaolin ships one preset, also named Kaolin. Uploading the package and opening the editor is all that is required — no app is needed for any feature in this theme.

2Theme settings

Typography

  • Heading font, body font — any face from Shopify's font library. The default pairing is a high-contrast serif against a neutral sans; keep the contrast.
  • Heading size, body text size — a global scale in percent, so type can grow without editing CSS.
  • Small label style — uppercase with wide tracking (default), or sentence case without tracking. One switch changes every eyebrow, button label and section caption.

Colors

Eight color settings: background, text, rule, accent, button background, button text, badge background, badge text. Brand colors set here apply across the storefront, including checkout entry points.

Layout

  • Maximum page width — 1200 to 1920 px. Wide values suit large furniture photography.
  • Section spacing — vertical rhythm between sections.
  • Media corner radius — 0 by default; the theme is built on square corners.
  • Show chapter marks — draws the numbered margin rail on large screens.
  • Sticky header — keeps the header pinned while scrolling.

Product cards

Image ratio, vendor on or off, quick add, hover second image, and color swatches. Quick add sends single-variant products straight to the cart and sends multi-variant products to the product page.

Cart

A drawer (default) or a cart page. The order note field can be turned off independently of that choice.

Search

Predictive search with a result limit of two to ten products. Search results and collections both support storefront filtering when filters are defined in the Shopify admin.

3Section library

Every section below can be added to any JSON template, reordered, or removed in the theme editor. All of them accept app blocks where Shopify allows app blocks.

SectionWhat it doesNotes
Opening spreadFull-bleed sliding hero with dotsSplit or stacked; tall, portrait or landscape media
Featured collectionProduct grid from a chosen collectionStaggered offset option; placeholder cards when empty
Lookbook mosaicImage tiles in a two- to four-column mosaicSpan and row height per tile
Two roomsTwo side-by-side panels with a vertical ruleBuilt for a room / wardrobe split
Editorial image with textLarge image beside a numbered text blockNormal, reversed or narrow layout
Collection listCollection tiles with product countsFalls back to a menu, then to placeholder art
Blog postsLatest articles in a three-up gridOptional excerpt and author
NewsletterEmail captureUses Shopify's customer form; tags subscribers
Rich textA single column of copyStart, center or end alignment
Custom LiquidFree-form LiquidNo presets, as Theme Store themes require
AppsApp blocks onlyFor embedding app content between sections
Announcement barTop message stripMultiple messages, optional link
Product recommendationsRelated or complementary productsUses Shopify's product recommendations API

4Templates

Every template is JSON except the password layout and the gift card template, which must stay Liquid.

HomeOpening spread, featured collection, lookbook, two rooms, editorial, blog, newsletter
ProductMedia gallery, fourteen content blocks, related and complementary rows
CollectionFilters, sorting, staggered grid, pagination
SearchPredictive search plus filtered results for products, articles and pages
CartLine items, discounts, selling plans, totals, accelerated checkout
Blog and articleArticle grid, tags, comments when enabled
PagesStandard page and contact form
Utility404, password, gift card, collection list

5Product page blocks

The product form is assembled from blocks, so the order is yours to set. The default order is below.

BlockContent
VendorProduct vendor
TitleProduct title, the page heading
PricePrice, compare-at price, unit price, tax and shipping note, sold-out note
Spec rowOne label and value row; add one per material, dimension or origin
Variant pickerOption radios, color swatches, sold-out states; the selected value sits beside the option name
QuantityStepper bound to the product form
Buy buttonsAdd to cart, dynamic checkout, Shop Pay Installments banner
Pickup availabilityLocal pickup status for the selected variant
DescriptionProduct description in a collapsible row
Collapsible rowCustom heading with rich text or a page reference
Custom LiquidAny Liquid, including app output
ShareFacebook, X, Pinterest, and copy link
App blockAny app that supports theme blocks

Selecting a variant updates the price, compare-at price, unit price, SKU, button label and availability, rewrites the browser URL, and scrolls the gallery to the variant image.

7Presets and demo content

Kaolin has a single preset named Kaolin. The home template ships with two opening slides, a featured collection, three lookbook tiles, two room panels, one editorial block, a blog row and a newsletter block, so a fresh install already looks finished. Replace the copy and images with your own; placeholder art appears wherever an image is missing.

Setting up a store from scratch: create the collections first, then the products, then the menus. Sections fall back gracefully, so it is safe to publish before the catalogue is complete.

8Support

Send a message through the support form with your store URL, the theme version from Theme settings, and the steps that reproduce the issue. We answer within two business days.

Open a support request — the form takes a name, an email and the message. Attach screenshots by pasting a link to the image.

9Changelog

VersionDateChanges
1.0.0November 2026First release: 13 storefront sections, JSON templates throughout, storefront filtering, predictive search, cart drawer, gift card template, market selectors.