Balm Docs v1.0.0

Sections and blocks

Every page in Balm is built from sections, and most sections hold blocks. In the theme editor, select Add section to add a section, or Add block inside a section to add a block. Drag them to reorder, and use the eye icon to hide one without deleting it.

Balm 1.0.0 12 min read

Every section has a Color scheme setting (Colors) and, under Padding, a Top padding and Bottom padding of None, Small, Medium or Large. They're not repeated in the tables below.

Eyebrow is the small label line above a heading, for example "The ritual".

The header and footer show on every page. Their sections live in the header and footer groups at the top and bottom of the theme editor's sidebar.

#Announcement bar

One line of text above the header, with an optional link. Add up to three Announcement blocks (Text, Link). Shows only when it has at least one block.

The brand row (search, logo, secondary menu, account and bag), then the ritual row: your main menu's first four links as the steps 01 to 04, any further links, and the AM/PM switch.

Setting What it does
Main menu The first four links become the ritual steps 01 to 04. Further links show after them. See Set up your main menu.
Secondary menu A few links next to the logo, for example "Journal" and "Our story"
Featured links Shows at the foot of the ritual menu
Customer account menu The links in the customer account menu
Show AM/PM switch Shows the morning and evening switch
Enable sticky header Keeps the header at the top of the screen as visitors scroll
PM color scheme Applies when the AM/PM switch is set to PM. Default Scheme 3 (Evening).

The account icon uses Shopify's customer accounts. Turn customer accounts on or off in Settings > Customer accounts.

Setting What it does
Show day dial A clock of the ritual: morning steps on one side, evening steps on the other
Show newsletter signup The signup form. Emails are added to your customer list with email marketing consent.
Show wordmark A large store name with the four-step stripe
Wordmark text Shows the store name when empty
Show country/region selector Shows when you sell in more than one country or region. Add countries in Settings > Markets.
Show language selector Shows when your store has more than one language. Add languages in Settings > Languages.
Show social media icons Add your accounts in Theme settings > Social media
Show Follow on Shop Shows when Shop Pay is turned on for your store
Show payment icons Icons for the payment methods your store accepts

Footer blocks:

Block Settings
Day dial Ritual link. Shows all products in Ritual view when empty.
Newsletter Eyebrow, Heading, Text, Note
Footer menu Heading, Footer menu (default: your Footer menu), Number steps (numbers the first four links 01 to 04, like the ritual steps)
Text Heading, Text. For a short note about your studio or brand.

The bottom bar shows the copyright, Powered by Shopify, and links to your store policies from Settings > Policies.

#Home page

Balm's home page ships with these sections, in this order. You can add any of them to other pages too.

#Image banner

A large image with a heading, text and buttons. Presets: Image banner and Image banner with steps.

Setting What it does
Image The banner image. Use an image at least 2000px wide.
Caption, Caption detail A small caption on the image
Show steps Shows a link to each step collection from Theme settings > Ritual, with the number of products in each

Blocks: Heading, Text, Button, Group (see Theme blocks).

#Step by step

A scroll story through the four steps: the image stays in place while the text moves.

Block Settings
Step (up to 4) Step, Image, Heading, Text, Product (shows the product and its dose under the text)

Section settings: Eyebrow, Heading.

#Build your ritual

Visitors pick a product for each step, morning or evening, and add the whole ritual to the bag in one go.

Setting What it does
Eyebrow, Heading, Text The section introduction
Show total Shows the total price and the button that adds every step to the bag
Block Settings
Ritual step (up to 4) Step; under Morning, Product and Alternative product; under Evening, Product and Alternative product

An empty product uses the first available product for that step from Theme settings > Ritual. Protect rests at night, so step 4 has no evening product.

#AM and PM rituals

Two columns, morning and evening, each with an image and its products in step order.

Block Settings
Ritual (up to 2) Time of day, Image, Heading, Text, Products, Button label, Link, Color scheme

When Products is empty, the column uses the first available product for each step from Theme settings > Ritual.

A grid of products from one collection.

Setting What it does
Eyebrow, Heading The section heading
Collection The collection to show
Link label The link to the full collection. Default "View all".
Products to show 2 to 12
Columns 3 columns or 4 columns

One product with its buy box, on any page. Presets: Featured product and Ritual set.

Setting What it does
Product The product to show
Media Product media, or Set products (a tile for each product in the set)
Set products The products in this set, up to 6. They show in the Set items block and in the media.

Blocks: the same blocks as the product page (see Product information), plus Set items, which lists the set products and what they'd cost bought separately, and app blocks.

The Ritual set preset is made for a bundle product, such as a morning set: create the bundle as a product, pick it in Product, then pick the products it contains in Set products.

#Key ingredients

Ingredients with their percentage, INCI name and a short text. Presets: Key ingredients (columns, for product pages) and Ingredient index (an interactive index, for the home page).

Setting What it does
Layout Columns or Index
Eyebrow, Heading The section heading
Text Shows in the Index layout
Link label, Link An optional link, for example to an ingredients page
Use step color On product pages, uses the color scheme of the product's step
Block Settings
Ingredient (up to 6) Percentage (for example 5%), Name, INCI name (the name on the label, for example Sodium hyaluronate), Text. Under Index layout: Step, Image, Caption, two label and value facts, Found in (products).

Ingredient settings accept dynamic sources, so on product pages you can connect them to your metafields and show different ingredients for each product.

#Before you begin

A dose guide: how much of each step to use, with an animated dose icon.

Setting What it does
Eyebrow, Heading, Text The section introduction
Link label, Link An optional link, for example to a full guide
Note A short note under the cards
Block Settings
Dose card (up to 4) Step, Dose icon (Match the step, Pump, Drops, Pea or Fingertip), Dose, Text, Note, Time of day

#Collection list

Collection tiles. Presets: Collection list and Shop by skin type.

Setting What it does
Eyebrow, Heading, Link label The section heading and a link
Columns 3 columns or 4 columns
Block Settings
Collection tile (up to 12) Collection, Link (when no collection is picked), Heading (uses the collection name when empty), Image (uses the collection image when empty), Start with (a step to start the ritual from)

#Image with text

An image next to a heading, text and buttons. Presets: Image with text and Story with figures.

Setting What it does
Image The image
Image position Left or Right
Image ratio Portrait, Square, Landscape or Adapt to image

Blocks: Heading, Text, Button, Group, and Figures: up to three numbers with labels, for example "4 steps" or "92%". Numbers count up when they come into view.

#Testimonials

Customer quotes, each with the ritual steps the customer uses.

Block Settings
Testimonial (up to 6) Quote, Name, Place; under Steps used, Cleanse, Treat, Moisturize, Protect

Use real customer words only, with their permission.

#Blog posts

Setting What it does
Eyebrow, Heading The section heading
Blog The blog to show
Link label The link to the blog. Default "View all".
Posts to show 2 to 9 articles

#More sections for any page

Section What it shows Blocks and key settings
Rich text Centered or left-aligned text Heading, Text, Button, Group; Alignment, Content width
Slideshow Slides with text panels. Visitors move between slides; it never moves on its own. Slide (up to 6): Image, Eyebrow, Heading, Text, Button label, Link, Panel color scheme; Image height
Multicolumn (preset Columns) Columns with an image, heading and text Column (up to 8): Image, Heading, Text, Link label, Link; Columns, Alignment, Show images, Image ratio
Collapsible content (preset FAQ) Questions and answers that open and close Collapsible row: Heading, Text, Open by default; Eyebrow, Heading, Text
Logo list Logos, for example of press or stockists Logo (up to 12): Image, Name, Link; Heading, Height
Newsletter A signup form Heading, Text; Note, Alignment
Video A YouTube or Vimeo video, or an uploaded file Heading, URL, File (takes priority over the URL), Cover image (16:9 aspect ratio recommended), Full width
Map Your address, opening hours and a directions link. No map service or key needed. Eyebrow, Heading, Address, Opening hours, Button label, Image
Contact form A contact form that sends to your store email Heading, Text
Custom Liquid Your own Liquid, HTML or app snippets Liquid code. See Custom code.

#Product page

The product template holds these sections: Product information, Complete the ritual, Key ingredients, Ingredient label and Related products.

#Product information

The media gallery and the buy box. The gallery shows images, videos, YouTube and Vimeo videos and 3D models; selecting a variant shows its image.

Setting What it does
Show breadcrumbs Shows the path above the product. The middle link goes to the product's step collection.
Show image captions Shows a figure number and the image alt text under each image

Blocks, in their default order:

Block Settings and notes
Ritual line The step tag ("02 Treat · Step 2 of 4") and AM/PM icons. Step (enter 1 to 4, or connect a metafield; uses the product's tags or metafields when empty), Show AM/PM.
Product name Show vendor
Description Text size (Large or Body)
Price Price, sale price, unit price and tax note. Show Shop Pay Installments (shows when Shop Pay Installments is available for the price).
Product facts Three label and value pairs, by default Texture, Finish and Skin type. Empty values use the product's ritual data or hide.
Variant picker Style (Buttons or Dropdown), Show option prices. Options with color or image swatches always show as swatches.
Buy buttons Quantity, add to cart and the dynamic checkout buttons. Show quantity selector, Show dynamic checkout buttons, Show recipient form (for gift cards).
Pickup availability Shows store pickup when you offer local pickup (Settings > Shipping and delivery). No settings.
Where it fits A four-step rail with this product's place. Heading, Current product label, Show ritual link.
Collapsible row Heading, Content (Text, How to use or Full ingredient list), Text, Open by default; under How to use, Dose and Dose icon. Presets: Collapsible row, How to use, Full ingredient list.
Text, Button, Custom Liquid Theme blocks for anything else
Apps App blocks from apps you install, such as reviews

How to use shows when to use the product (for example "Use morning and evening, after cleansing"), the dose and its icon, then your text. Full ingredient list shows the balm.ingredients metafield, or your text when the metafield is empty.

#Complete the ritual

The four steps with one product each, as explained in Complete the ritual.

Setting What it does
Eyebrow The small label above the section
Show total Shows the total price and the button that adds every step to the bag

#Ingredient label

The product's ingredient list, styled like a printed label, with side facts.

Setting What it does
Heading The label heading
Ingredients Uses the balm.ingredients metafield when empty
Block Settings
Label fact (up to 6) Label, Value. Leave the value empty to hide this fact. Connect a metafield to show a different value for each product.

Products Shopify recommends for this one. Settings: Eyebrow, Heading, Link label, Link, Products to show. Manage recommendations in the Search and Discovery app (Related products).

#Collection page

#Product grid

Setting What it does
Show breadcrumbs Shows the path above the collection
Show collection image Shows the collection image next to the heading
Show step links Links to the step collections in Theme settings > Ritual
Enable Ritual view Adds a Grid and Ritual view switch. Ritual view groups products by step.
Show filters Shows the filters you set up in the Search and Discovery app
Show sorting Shows the sort menu
Products per page The number of products before the page links

Ritual view uses the collection template named ritual. Change its Product grid settings there. See Ritual view.

#Collections list

The page at /collections that lists all your collections. Settings: Columns, Collections per page, Show description. A collection without an image shows its first product's image.

Search results shows products as product cards, then pages and articles, with the same filters as collections. Settings: Results per page. When nothing matches, it says so and links to all products.

#Cart

Cart (the cart page) and Cart drawer show the same content: the products in step order, the ritual coverage rail, the missing step suggestion, the cart note, discounts, the subtotal and the checkout buttons. Their options are in Theme settings > Cart. The drawer has a Color scheme setting of its own.

#Other pages

Section Page Settings
Page Pages you create in Online Store > Pages Content width (Narrow or Wide)
Blog The blog page Show tags, Articles per page
Article Each blog post, with comments when you allow them on the blog Show image, Show date, Show author, Show tags, Show previous and next links
Not found The 404 page None besides colors and padding
Password The password page Shows the logo from Theme settings > Logo, or the store name. The message comes from Settings > Preferences.

The Contact page template (page.contact) has Page and Contact form sections. To use it, create a page in Online Store > Pages and pick contact as its template.

The gift card page that customers get by email shows the card's code, a QR code and an Add to Apple Wallet button. It has no settings.

#Theme blocks

These blocks can go in any section that has Add block with theme blocks: Image banner, Image with text, Rich text, Newsletter, Featured product and the product page's Product information.

Block Settings
Heading Eyebrow, Heading, Heading level (H1 to H4), Size (Display, Large, Medium, Small)
Text Text, Text size (Small, Body, Large)
Button Button label, Link, Style (Primary, Secondary, Text), Full width
Image Image, Image ratio
Group Holds other blocks side by side or stacked. Layout direction, Alignment, Grid spacing.
Custom Liquid Liquid code

Use Heading level for the page structure (one H1 per page, which the page's main heading already uses) and Size for the look.

These pages describe Balm 1.0.0 and are updated with every release. See the release notes for what changed.

Type to search every page: settings, sections, tags, metafields and the FAQ.

↑↓ to move Enter to open Esc to close