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.
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".
#Header and footer
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.
#Header
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.
#Footer
| 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.
#Featured collection
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 |
#Featured product
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. |
#Related products
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
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.