Sections and blocks
Every section and block in Touchmark, with its name as the theme editor shows it, what it is for, where it can go and all of its settings.
Sections are the full-width rows of a page. Add one with Add section in the editor sidebar. Blocks are the parts inside a section. Add one with Add block under the section. Sections marked any theme block take every block in Blocks; others take only their own blocks, listed with them.
Sections
Grouped as the Add section picker groups them. Sections without a category come first in the picker.
Banners
Opening sections and large media.
Image banner
The opening banner: an image beside the text, or a full-width image behind it, with heading, text, buttons, a rating line and a details row. An optional lab result tag on the image shows one measured value, such as the potency of a product's newest lab batch, and Show layout grid draws the 12-column layout grid behind the section on larger screens.
- In the Add section picker
- Image banner (Banners), Full-width image banner (Banners)
- Where
- Any template. Not in the header or footer. In the theme as shipped: Home page.
- Blocks
- Heading, Text, Button, Icon with text, Spacer, Rating and Details row (built in)
- Most blocks
- 10
Settings (23)
| Setting | Type and default | What it does |
|---|---|---|
| Layout | Options: Image beside text, Text over a full-width image, Text only. Default: Image beside text | |
| Image | Image | Use a portrait image for the split layout and a landscape image for full width. Set the focal point in the image editor to control the crop. Shows when Layout is not “Text only”. |
| Show first on mobile | Options: Image, Text. Default: Image | Shows when Layout is “Image beside text”. |
| Image beside text | ||
| Image position | Options: Right, Left. Default: Right | Shows when Layout is “Image beside text”. |
| Image width | Options: Wide, Narrow. Default: Wide | Shows when Layout is “Image beside text”. |
| Image ratio | Options: Portrait, 4:5; Tall, 3:4; Square, 1:1; Landscape, 3:2. Default: Portrait, 4:5 | On desktop the image fills the height of the text beside it, so the ratio sets its smallest height. Phones show a 4:3 band. Shows when Layout is “Image beside text”. |
| Show figure caption | Checkbox, on by default | Shows when Layout is “Image beside text”. |
| Image caption | Text | Leave empty to use the image's alt text. Screen readers then hear the description once, from the caption. Shows when Layout is “Image beside text” and Show figure caption is on. |
| Full-width image | ||
| Height | Options: Small, Medium, Large. Default: Medium | Shows when Layout is “Text over a full-width image”. |
| Text position | Options: Top left, Top center, Top right, Middle left, Middle center, Middle right, Bottom left, Bottom center, Bottom right. Default: Bottom left | Shows when Layout is “Text over a full-width image”. |
| Text background | Options: None, tint the image; Solid panel. Default: None, tint the image | A solid panel keeps text readable on any image. Shows when Layout is “Text over a full-width image”. |
| Image tint | 40 to 90 %, default 65 % | Tints the image with the color scheme's background color. Lower values show more of the image but can leave text unreadable over bright photos. Shows when Layout is “Text over a full-width image”. |
| Show layout grid | Checkbox, off by default | Draws the 12-column layout grid as fine lines behind this section on larger screens. Shows when Layout is not “Text over a full-width image”. |
| Lab result tag | ||
| Lab result tag on the image | Checkbox, off by default | A small tag on the image with one measured value, such as a lab result. It shows only when it has a value and the banner has an image. Shows when Layout is not “Text only”. |
| Product | Product | Used with the lab result tag: shows the first potency result of this product's newest lab batch. Leave empty to type a value below. How to set it up |
| Label | Text | Shows when Layout is not “Text only” and Lab result tag on the image is on. |
| Value | Text | Shows when Layout is not “Text only” and Lab result tag on the image is on. |
| Description | Text | Shows when Layout is not “Text only” and Lab result tag on the image is on. |
| Tag position | Options: Top left, Top right, Bottom left, Bottom right. Default: Bottom right | With a focal point set on the image, the tag lines up with it and a leader line runs to it from this side. On phones the tag sits on the bottom corner away from the focal point. Shows when Layout is not “Text only” and Lab result tag on the image is on. |
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 0 px | |
| Bottom padding | 0 to 160 px, default 0 px | |
| Show divider above | Checkbox, off by default | |
Rating
A product's star rating and review count from its rating metafields, then a short text. Nothing shows for a product without reviews.
- Kind
- Only inside Image banner.
Settings (2)
| Setting | Type and default | What it does |
|---|---|---|
| Product | Product | Shows the product's star rating and review count, which your reviews app adds to the product. With no reviews the line is hidden on your store, text included. |
| Text | Text | Shown after the rating, for example "on Magnesium Glycinate". |
Details row
The row of details in the banner. It holds Detail blocks.
- Kind
- Built into Image banner. You edit its settings, but you can't remove it or add another.
- Takes
- Detail
Settings (0)
| Setting | Type and default | What it does |
|---|---|---|
| A row of short labeled details above the heading, such as an edition, a product count or the latest batch. | ||
Detail
One label and value: typed text, a product's latest lab batch, or a number of products.
- Kind
- Only inside Details row.
Settings (5)
| Setting | Type and default | What it does |
|---|---|---|
| Label | Text | |
| Show | Options: Custom text, A product's latest batch, Number of products. Default: Custom text | |
| Text | Text | Leave empty to hide this detail. Shows when Show is “Custom text”. |
| Product | Product | Used when Show is set to a product's latest batch: the batch code, test date and status of its newest lab batch. How to set it up |
| Collection | Collection | Used when Show is set to Number of products. Leave empty to count every product in your store. |
Image with text
An image or video beside any theme blocks. The Image with specifications preset adds a specification list.
- In the Add section picker
- Image with text (Banners), Image with specifications (Banners)
- Where
- Any template. Not in the header or footer. In the theme as shipped: About page.
- Blocks
- Heading, Text, Button, Image, Icon with text, List item, Key figure, Group, Divider, Spacer, Custom Liquid and app blocks
Settings (14)
| Setting | Type and default | What it does |
|---|---|---|
| Image | Image | |
| Video | Video | Replaces the image and plays with its own controls. |
| Image ratio | Options: Natural; Portrait, 4:5; Tall, 3:4; Square, 1:1; Landscape, 3:2. Default: Portrait, 4:5 | |
| Round image corners | Checkbox, off by default | |
| Show figure caption | Checkbox, on by default | |
| Image caption | Text | Describe what the image shows. Leave empty to use the image's alt text. Shows when Show figure caption is on. |
| Layout | ||
| Image position | Options: Left, Right. Default: Left | |
| Image width | Options: Narrow, Half, Wide. Default: Half | |
| Vertical alignment | Options: Top, Middle, Bottom. Default: Middle | |
| Show first on mobile | Options: Image, Text. Default: Image | |
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 96 px | |
| Bottom padding | 0 to 160 px, default 96 px | |
| Show divider above | Checkbox, off by default | |
Slideshow
Full-width slides, each with an image, heading, text and two buttons. Slides change by hand, or automatically with a pause button.
- In the Add section picker
- Slideshow (Banners)
- Where
- Any template. Not in the header or footer.
- Blocks
- Slide
- Most blocks
- 6
Settings (9)
| Setting | Type and default | What it does |
|---|---|---|
| Width | Options: Full width, Page width. Default: Full width | |
| Height | Options: Small, Medium, Large, Match the first image. Default: Medium | |
| Change slides automatically | Checkbox, off by default | Visitors can pause it. It never moves for visitors who reduce motion, or in the theme editor. |
| Change slides every | 4 to 10 s, default 6 s | Shows when Change slides automatically is on. |
| Slideshow name | Text | Read out by screen readers, for example "New products". |
| Color scheme | Color scheme, default Scheme 4 | Slide text uses the scheme's text color over a tint of its background color. |
| Padding | ||
| Top padding | 0 to 160 px, default 0 px | |
| Bottom padding | 0 to 160 px, default 16 px | |
| Show divider above | Checkbox, off by default | |
Slide
One slide: image, heading, text and two buttons.
- Kind
- Only inside Slideshow.
Settings (12)
| Setting | Type and default | What it does |
|---|---|---|
| Image | Image | Use a landscape image at least 2000 pixels wide. Set the focal point to keep the subject in view on phones. |
| Label | Text | Short text above or beside the heading, such as a topic. With Theme settings > Layout > Section numbering on, only headings with a label get a number. |
| Heading | Text | |
| Heading size | Options: Display, Extra large, Large. Default: Extra large | |
| Text | Formatted text | |
| First button label | Text | |
| First button link | Link | The button shows on your store once it has a link. |
| Second button label | Text | |
| Second button link | Link | The button shows on your store once it has a link. |
| Layout | ||
| Text position | Options: Top left, Top center, Top right, Middle left, Middle center, Middle right, Bottom left, Bottom center, Bottom right. Default: Bottom left | |
| Text background | Options: None, tint the image; Solid panel. Default: None, tint the image | A solid panel keeps text readable on any image. |
| Image tint | 0 to 90 %, default 65 % | Tints the image with the color scheme's background color. Lower values show more of the image but can leave text unreadable over bright photos. |
Video
A YouTube, Vimeo or uploaded video with a cover image, description and caption.
- In the Add section picker
- Video (Banners)
- Where
- Any template. Not in the header or footer.
Settings (19)
| Setting | Type and default | What it does |
|---|---|---|
| YouTube or Vimeo link | YouTube or Vimeo link | The video loads only when a visitor presses play. |
| Uploaded video | Video | Plays instead of the YouTube or Vimeo link. |
| Play uploaded video automatically | Checkbox, off by default | Plays muted and on a loop, with a pause button. It stays still for visitors who reduce motion. Shows when Uploaded video is set. |
| Cover image | Image | Shown until the video plays. Use a frame from the video. |
| Video description | Text | Describe the video for screen reader users, for example "How we test each batch, 2 minutes". |
| Caption | Text | |
| Aspect ratio | Options: Wide, 16:9; Landscape, 3:2; Square, 1:1; Portrait, 4:5. Default: Wide, 16:9 | |
| Width | Options: Page width, Full width. Default: Page width | |
| Heading | ||
| Label | Text | Short text above or beside the heading, such as a topic. With Theme settings > Layout > Section numbering on, only headings with a label get a number. |
| Heading | Text | |
| Heading layout | Options: Full width, Hidden. Default: Full width | Full width suits grids. Hidden keeps it for screen readers. |
| Show section number | Checkbox, on by default | Shows when Label is set, Heading layout is not “Hidden” and Theme settings > Layout > Section numbering is not “Off”. |
| Text | Formatted text | |
| Link label | Text | |
| Link | Link | |
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 96 px | |
| Bottom padding | 0 to 160 px, default 96 px | |
| Show divider above | Checkbox, off by default | |
Collections
Collections, goals and product grids for any page.
Collection list
The collections you choose, as cards with images or as compact links with thumbnails, with optional product counts and descriptions.
- In the Add section picker
- Collection list (Collections), Collection links (Collections)
- Where
- Any template. Not in the header or footer.
Settings (19)
| Setting | Type and default | What it does |
|---|---|---|
| Collections | Collections | |
| Style | Options: Cards with images, Compact links with thumbnails. Default: Cards with images | |
| Columns on desktop | 2 to 6, default 4 | Shows when Style is “Cards with images”. |
| Layout on mobile | Options: Swipe row, Grid. Default: Swipe row | Shows when Style is “Cards with images”. |
| Columns on mobile | Options: 1, 2. Default: 2 | Shows when Style is “Cards with images” and Layout on mobile is “Grid”. |
| Image ratio | Options: Portrait, 4:5; Square, 1:1; Landscape, 3:2. Default: Portrait, 4:5 | Shows when Style is “Cards with images”. |
| Show product count | Checkbox, on by default | |
| Show collection description | Checkbox, off by default | Shows when Style is “Cards with images”. |
| Heading | ||
| Label | Text | Short text above or beside the heading, such as a topic. With Theme settings > Layout > Section numbering on, only headings with a label get a number. |
| Heading | Text | |
| Heading layout | Options: Full width, Hidden. Default: Full width | Full width suits grids. Hidden keeps it for screen readers. |
| Show section number | Checkbox, on by default | Shows when Label is set, Heading layout is not “Hidden” and Theme settings > Layout > Section numbering is not “Off”. |
| Text | Formatted text | |
| Link label | Text | |
| Link | Link | |
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 96 px | |
| Bottom padding | 0 to 160 px, default 96 px | |
| Show divider above | Checkbox, off by default | |
Featured collection
Product cards from one collection. The Collection tabs preset shows several collections as tabs, one Collection tab block each.
- In the Add section picker
- Featured collection (Collections), Collection tabs (Collections)
- Where
- Any template. Not in the header or footer. In the theme as shipped: Home page.
- Blocks
- Collection tab
- Most blocks
- 6
Settings (16)
| Setting | Type and default | What it does |
|---|---|---|
| Collection | Collection | Ignored when the section has collection tabs. |
| Products to show | 2 to 16, default 8 | |
| Columns on desktop | 2 to 5, default 4 | |
| Layout on mobile | Options: Swipe row, Grid. Default: Swipe row | |
| Columns on mobile | Options: 1, 2. Default: 2 | Shows when Layout on mobile is “Grid”. |
| Dividers between products | Checkbox, on by default | Products sit in cells with dividers between them instead of open cards. |
| Heading | ||
| Label | Text | Short text above or beside the heading, such as a topic. With Theme settings > Layout > Section numbering on, only headings with a label get a number. |
| Heading | Text | |
| Heading layout | Options: Full width, Hidden. Default: Full width | Full width suits grids. Hidden keeps it for screen readers. |
| Show section number | Checkbox, on by default | Shows when Label is set, Heading layout is not “Hidden” and Theme settings > Layout > Section numbering is not “Off”. |
| Text | Formatted text | Shows when Heading layout is not “Hidden”. |
| Show "View all" link | Checkbox, on by default | A link to the collection at the right of the heading. Shows when Heading layout is not “Hidden”. |
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 80 px | |
| Bottom padding | 0 to 160 px, default 80 px | |
| Show divider above | Checkbox, off by default | |
Collection tab
One tab: a collection and its tab label.
- Kind
- Only inside Featured collection.
Settings (2)
| Setting | Type and default | What it does |
|---|---|---|
| Collection | Collection | |
| Tab label | Text | Leave empty to use the collection title. |
Shop by goal
Shop by goal: numbered rows linking to your goal collections, each with its key ingredients, product count and an image that changes as shoppers move down the list. Rows come from Goal blocks, the section's Collections, or Theme settings > Goals. An optional closing row under the list links to your quiz or a guide page; it shows once it has a link.
- In the Add section picker
- Shop by goal (Collections)
- Where
- Any template. Not in the header or footer. In the theme as shipped: Home page.
- Blocks
- Goal
- Most blocks
- 12
Settings (18)
| Setting | Type and default | What it does |
|---|---|---|
| Collections | Collections | Leave empty to use Theme settings > Goals. Key ingredients and marker colors come from collection metafields. How to set them up |
| Show key ingredients | Checkbox, on by default | Shows each collection's Key ingredients metafield, or the key ingredients typed in a goal block. |
| Show product count | Checkbox, on by default | |
| Show image | Checkbox, on by default | With four or more collections, the image fills the height of the list and changes as visitors move through it. With up to three, each collection shows as an image tile. |
| Heading | ||
| Label | Text | Short text above or beside the heading, such as a topic. With Theme settings > Layout > Section numbering on, only headings with a label get a number. |
| Heading | Text | Leave empty to use "Shop by goal", or "Shop by collection" while no goals are chosen. |
| Heading layout | Options: Full width, Stacked, Hidden. Default: Full width | Full width suits grids. Stacked keeps the heading in the content column. Hidden keeps it for screen readers. |
| Show section number | Checkbox, on by default | Rows are then numbered after the section, like 1.1 and 1.2. Shows when Label is set, Heading layout is not “Hidden” and Theme settings > Layout > Section numbering is not “Off”. |
| Text | Formatted text | Shows when Heading layout is not “Hidden”. |
| Link label | Text | Shows when Heading layout is not “Hidden”. |
| Link | Link | Shows when Heading layout is not “Hidden”. |
| Closing link | ||
| A last row under the list, for a quiz or a guide page. | ||
| Heading | Text | |
| Link label | Text | |
| Link | Link | The row shows once it has a link. |
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 80 px | |
| Bottom padding | 0 to 160 px, default 80 px | |
| Show divider above | Checkbox, off by default | |
Goal
One goal row: a collection, with an optional heading, key ingredients, accent color and image that replace the collection's own.
- Kind
- Only inside Shop by goal.
Settings (5)
| Setting | Type and default | What it does |
|---|---|---|
| Collection | Collection | |
| Heading | Text | Leave empty to use the collection title. |
| Key ingredients | Text | Leave empty to use the collection's Key ingredients metafield. How to set it up |
| Accent color | Color | Colors the small goal marker. Leave empty to use the collection's Accent color metafield. |
| Image | Image | Leave empty to use the collection image. |
Products
Product sections you can add to any page, and the sections that sell subscriptions and the quiz.
Featured product
The gallery and buy box of one product you choose, on any page. It takes the same blocks as Product information, so the product chapters can sit here too.
- In the Add section picker
- Featured product (Products)
- Where
- Any template. Not in the header or footer.
- Blocks
- any theme block and app blocks
Settings (15)
| Setting | Type and default | What it does |
|---|---|---|
| Product | Product | |
| Show link to the product page | Checkbox, on by default | |
| Layout | ||
| Desktop layout | Options: Wide media, Equal columns. Default: Wide media | |
| Media position on desktop | Options: Left, Right. Default: Left | |
| Keep product details in view while scrolling | Checkbox, off by default | Desktop. Product details stay in view while the gallery scrolls. Details taller than the screen stick by their bottom edge. |
| Media | ||
| Gallery layout | Options: Stacked figures, Thumbnails. Default: Thumbnails | Stacked shows every media as a figure; two media share a row only when they have the same shape. On mobile, both layouts become a swipe carousel with a counter. |
| Media shape | Options: Natural, Square, Portrait. Default: Natural | Natural keeps each image's own shape, so nothing is cropped. |
| Media fit | Options: Fit inside, Fill and crop. Default: Fit inside | Shows when Media shape is not “Natural”. |
| Show figure captions | Checkbox, off by default | Uses each image’s alt text as its figure caption. Leave off when alt text is written only for screen readers. |
| Open images in a zoom view | Checkbox, on by default | |
| Loop videos | Checkbox, off by default | |
| Color scheme | ||
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 64 px | |
| Bottom padding | 0 to 160 px, default 64 px | |
| Show divider above | Checkbox, off by default | |
Quiz
The product finder quiz: an introduction, questions with answers, then suggested products ranked from the answers, with an order summary that adds them all to the cart.
- In the Add section picker
- Quiz (Products)
- Where
- Any template. Not in the header or footer. In the theme as shipped: Quiz page.
- Blocks
- Question
- Most blocks
- 12
Settings (19)
| Setting | Type and default | What it does |
|---|---|---|
| Label | Text | Short text above or beside the heading, such as a topic. With Theme settings > Layout > Section numbering on, only headings with a label get a number. |
| Heading | Text | |
| Text | Formatted text | |
| Start button label | Text | |
| Time estimate | Text | For example, how long the quiz takes. Leave empty to hide it. |
| Reassurance | Text | |
| Image | Image | Shown beside the introduction. Without an image, the questions are listed there instead. |
| Results | ||
| Results heading | Text | |
| Results text | Formatted text | |
| Products to suggest | Collection | The quiz suggests products from this collection, plus any products picked on answers. Leave empty to use all products. |
| Products to consider | 4 to 50, default 24 | |
| Leave out products with this tag | Text | For example bundle, so a routine never lists the same product twice. |
| Number of suggestions | 2 to 4, default 3 | |
| Show order summary | Checkbox, on by default | Lets shoppers choose one-time or subscription once and add every suggestion in one step. |
| Reassurance note | Formatted text | Shown under the results. |
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 64 px | |
| Bottom padding | 0 to 160 px, default 96 px | |
| Show divider above | Checkbox, off by default | |
Question
One question with its Quiz answer blocks, answer layout and ranking weight.
- Kind
- Only inside Quiz.
- Takes
- Quiz answer
Settings (7)
| Setting | Type and default | What it does |
|---|---|---|
| Question | Text | |
| Help text | Text | Shown under the question. Questions that allow more than one answer say so when this is empty. |
| Allow more than one answer | Checkbox, off by default | |
| Answer layout | Options: List, Grid. Default: List | Grid suits answers with images. |
| Ranking | ||
| Weight | 0 to 5, default 1 | Multiplies the points this question gives products. Use 3 for the question about the main goal, or 0 to leave a question out of the ranking. |
| Use this question to pick the first result | Checkbox, off by default | The first suggestion matches the answer chosen here. When no product matches it, the results say so. |
| Treat its filters as a preference | Checkbox, off by default | For a question about formats. If its filters would leave no match for the first-result question, the best match stays first and its result says how it differs, such as "Comes as capsules". |
Quiz answer
One answer and the products it suggests: picked products, a collection or a tag, with optional filters.
- Kind
- Only inside Question.
Settings (11)
| Setting | Type and default | What it does |
|---|---|---|
| Answer | Text | |
| Description | Text | |
| Image | Image | Use the grid layout on the question for answers with images. |
| Value | Text | Used in links that preselect an answer on the first question, such as ?q1=sleep. Leave empty to use the answer in lowercase with hyphens. |
| Clear the other answers when chosen | Checkbox, off by default | For answers such as "None of these" on a question that allows more than one answer. |
| Results | ||
| Products picked here count most, then products in the collection, then products with the tag. The question weight multiplies these points. A tag on its own adds points but does not suggest a product. | ||
| Short label | Text | Shown in each result's "Matches" line, for example "falling asleep". Leave empty to use the answer. |
| Suggest these products | Products | |
| Suggest products from this collection | Collection | |
| Suggest products with this tag | Text | Product tags are set in Shopify admin. |
| Only suggest products with this tag | Checkbox, off by default | For needs such as a vegan diet or a format. Answers in one question widen the results; answers in different questions narrow them. When no product passes, the closest matches show with a note. Shows when Suggest products with this tag is set. |
| Note with the results | Text | Shown with the results when this answer is chosen, for example a reminder to check with a pharmacist. |
Quiz call to action
A short prompt that leads into the quiz: heading, text, the quiz's first question as answer chips, a button and reassurance lines. It needs a page that uses the quiz template.
- In the Add section picker
- Quiz call to action (Products)
- Where
- Any template. Not in the header or footer.
- Blocks
- Reassurance and First question (built in)
- Most blocks
- 3
Settings (10)
| Setting | Type and default | What it does |
|---|---|---|
| Label | Text | Short text above or beside the heading, such as a topic. With Theme settings > Layout > Section numbering on, only headings with a label get a number. |
| Heading | Text | |
| Heading layout | Options: Centered, Hidden. Default: Centered | Centered suits a closing call to action. Hidden keeps it for screen readers. |
| Text | Text | |
| Button label | Text | |
| Quiz page | Page | The page that uses the quiz template. The button opens it, and each answer opens it with that answer chosen. Without a quiz page the section stays hidden. |
| Section | ||
| Anchor link | Text | Lets a menu link jump to this section, for example /pages/science#lab-results. Use lowercase letters and hyphens. |
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 96 px | When the background color changes between two sections, each keeps at least 64px of space, whatever this setting says. |
| Bottom padding | 0 to 160 px, default 96 px | When the background color changes between two sections, each keeps at least 64px of space, whatever this setting says. |
Reassurance
One short line under the button.
- Kind
- Only inside Quiz call to action.
Settings (1)
| Setting | Type and default | What it does |
|---|---|---|
| Text | Text | Shown with the other reassurance points as one line of small text under the button. Leave empty to hide it. |
First question
The quiz's first question, shown as answer chips.
- Kind
- Built into Quiz call to action. You edit its settings, but you can't remove it or add another.
- Takes
- Answer link
Settings (3)
| Setting | Type and default | What it does |
|---|---|---|
| Add the answers to the quiz's first question to this block. Each answer opens the quiz page with that answer chosen. | ||
| Question | Text | Use the same wording as the first question in your quiz. |
| Show how customers answered | Checkbox, off by default | Only use shares from your own quiz results. |
| Note under the answers | Text | Shows when Show how customers answered is on. |
Answer link
One answer chip that opens the quiz with that answer chosen.
- Kind
- Only inside First question.
Settings (3)
| Setting | Type and default | What it does |
|---|---|---|
| Answer | Text | Use the same wording as in the quiz. |
| Answer value | Text | This answer's value in the quiz's first question. When it matches no answer there, the link opens the quiz at question 1 with nothing chosen. Leave empty to use the answer in lowercase, with hyphens. |
| Share of customers | Number | Optional percentage, shown when the First question block shows how customers answered. |
Routine builder
Routine builder: shoppers pick products and sizes and add them all to the cart in one step. Products come from the section's product list, a collection, or all products. The summary shows the cost per day: Per day of use in both modes, each price divided by the days it lasts, capped at the next delivery for a subscribed line. Short lines are named beside that figure. The first unmatched subscription add shows Not added yet and asks for a fix or Add anyway. The selected variant's quantity limits set the smallest legal count; totals, supply and cart additions use that count.
- In the Add section picker
- Routine builder (Products)
- Where
- Any template. Not in the header or footer. In the theme as shipped: Routine builder page.
Settings (13)
| Setting | Type and default | What it does |
|---|---|---|
| Label | Text | Short text above or beside the heading, such as a topic. With Theme settings > Layout > Section numbering on, only headings with a label get a number. |
| Heading | Text | |
| Text | Formatted text | |
| Products | ||
| Products | Products | |
| Collection | Collection | Used when no products are picked above. |
| Products to show from the collection | 2 to 24, default 12 | |
| Summary | ||
| Summary heading | Text | |
| Discount message | Text | Shown in the summary. The theme does not apply discounts: create a matching automatic discount in Shopify admin under Discounts. The cart then shows it. |
| Products the discount needs | 0 to 6, default 0 | Tells shoppers how many more products to add. Use 0 to hide the count. Shows when Discount message is set. |
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 64 px | |
| Bottom padding | 0 to 160 px, default 96 px | |
| Show divider above | Checkbox, off by default | |
Subscription steps
How a subscription works: steps on a scale of days, a savings calculator for one product's subscription plans with the price per day, and an optional preview of the delivery slip.
- In the Add section picker
- Subscription steps (Products)
- Where
- Any template. Not in the header or footer. In the theme as shipped: Home page.
- Blocks
- Subscription step and Delivery slip (built in)
- Most blocks
- 6
Settings (23)
| Setting | Type and default | What it does |
|---|---|---|
| Opening | Options: Heading row, Image split. Default: Heading row | Image split shows the lead image beside the calculator on screens 990px and wider. Phones leave it out. Without a lead image the heading row shows. |
| Lead image | Image | Portrait, 2:3, 960px wide or more. Shows when Opening is “Image split”. |
| Label | Text | Short text above or beside the heading, such as a topic. With Theme settings > Layout > Section numbering on, only headings with a label get a number. |
| Heading | Text | |
| Heading layout | Options: Left with line above, Left, Full width, Large, Stacked, Centered, Hidden. Default: Stacked | Left aligns with the content below. Full width suits grids. Use Large once a page. Hidden keeps it for screen readers. |
| Show section number | Checkbox, on by default | Shows when Label is set, Heading layout is neither “Centered” nor “Hidden” and Theme settings > Layout > Section numbering is not “Off”. |
| Text | Formatted text | |
| Link label | Text | |
| Link | Link | |
| Timeline | ||
| Steps sit at equal spacing. Give two steps in a row a day, such as Day 25 and Day 30, and the line between them shows the gap (5 days). A step with no day, such as Any time, gets a dashed line. | ||
| Note under the timeline | Text | |
| Footnote | Text | Adds a numbered note at the bottom of the page. Use it for sources, sample sizes and claims. Shows when Note under the timeline is set. |
| Savings calculator | ||
| Product | Product | Leave empty to use the first product with subscription plans. With a Servings metafield, each cadence shows units per delivery and the price per day. |
| Calculator heading | Text | Leave empty to use the product and variant name. |
| Show price per day | Checkbox, on by default | Shows when the product has a Servings metafield: each delivery's price divided by the days it lasts. |
| Shipping text, one-time orders | Text | Leave both shipping fields empty to hide the row. Only enter what your shipping rates charge. |
| Shipping text, subscriptions | Text | |
| Note under the calculator | Text | Leave empty to say: Yearly totals count whole deliveries at today's prices. |
| Button label | Text | Links to the product page with the chosen plan selected. When a delivery holds more than one, the button says how many to get. Leave empty to hide the button. |
| Show delivery slip | Checkbox, on by default | An example delivery at the cadence the calculator shows. |
| Section | ||
| Anchor link | Text | Lets a menu link jump to this section, for example /pages/science#lab-results. Use lowercase letters and hyphens. |
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 96 px | When the background color changes between two sections, each keeps at least 64px of space, whatever this setting says. |
| Bottom padding | 0 to 160 px, default 96 px | When the background color changes between two sections, each keeps at least 64px of space, whatever this setting says. |
Subscription step
One step. A label with a day number, such as Day 25, places it on the scale.
- Kind
- Only inside Subscription steps.
Settings (4)
| Setting | Type and default | What it does |
|---|---|---|
| Label | Text | A short marker such as Day 30. Days in neighbouring steps label the line between them with the gap. Leave the number out for a step with no date, such as Any time. |
| Heading | Text | |
| Text | Text | One line under the heading. |
| Footnote | Text | Adds a numbered note at the bottom of the page. Use it for sources, sample sizes and claims. |
Delivery slip
A preview of the next delivery slip, which follows the plan chosen in the calculator.
- Kind
- Built into Subscription steps. You edit its settings, but you can't remove it or add another.
Settings (3)
| Setting | Type and default | What it does |
|---|---|---|
| An example delivery at the cadence the calculator shows, dated today plus that cadence. The line about managing a subscription follows Theme settings > Subscriptions > Subscription management link. | ||
| Heading | Text | |
| Actions | Text, several lines | What customers can do with a subscription in your subscription app, one per line, such as Skip a delivery. Leave empty to list none. |
| Caption | Text | Leave empty to use: Example delivery, priced from the [product] plan. |
Science
Sections that show product data: lab results, ingredients and timelines.
Ingredient trace
A card per ingredient: name, dose, form, source, origin and why it is in the formula. Cards come from a product's Ingredients metafield, or from Ingredient card blocks. It can open with a full-width lead image.
- In the Add section picker
- Ingredient trace (Science)
- Where
- Any template. Not in the header or footer. In the theme as shipped: Home page and Science page.
- Blocks
- Ingredient card
- Most blocks
- 12
Settings (19)
| Setting | Type and default | What it does |
|---|---|---|
| Opening | Options: Heading row, Image band. Default: Heading row | Image band sets the lead image across the page with the heading over one side, then the cards. Without a lead image the heading row shows. |
| Lead image | Image | Landscape, 2400px wide or more, with a calm area on one side for the heading. The heading sits on a shade of the section's background so it stays readable. Shows when Opening is “Image band”. |
| Heading side | Options: Left, Right. Default: Left | Shows when Opening is “Image band”. |
| Label | Text | Short text above or beside the heading, such as a topic. With Theme settings > Layout > Section numbering on, only headings with a label get a number. |
| Heading | Text | |
| Heading layout | Options: Left with line above, Left, Full width, Large, Stacked, Centered, Hidden. Default: Stacked | Left aligns with the content below. Full width suits grids. Use Large once a page. Hidden keeps it for screen readers. |
| Show section number | Checkbox, on by default | Shows when Label is set, Heading layout is neither “Centered” nor “Hidden” and Theme settings > Layout > Section numbering is not “Off”. |
| Text | Formatted text | |
| Link label | Text | |
| Link | Link | |
| Cards | ||
| Product | Product | Shows the ingredients in the product's Ingredients metafield. When it has none, the Ingredient card blocks show. On a product page, leave empty to use that product. |
| Columns on desktop | Options: 2, 3, 4. Default: 3 | |
| Image ratio | Options: Square, 1:1; Portrait, 4:5; Landscape, 3:2. Default: Square, 1:1 | When any ingredient has no image, every card shows a 4:3 name tag with its source and origin instead. |
| Note under the cards | Text | |
| Footnote | Text | Adds a numbered note at the bottom of the page. Use it for sources, sample sizes and claims. Shows when Note under the cards is set. |
| Section | ||
| Anchor link | Text | Lets a menu link jump to this section, for example /pages/science#lab-results. Use lowercase letters and hyphens. |
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 96 px | With the image band, this is the space between the photograph and the cards. |
| Bottom padding | 0 to 160 px, default 96 px | When the background color changes between two sections, each keeps at least 64px of space, whatever this setting says. |
Ingredient card
One ingredient card typed into the section.
- Kind
- Only inside Ingredient trace.
Settings (9)
| Setting | Type and default | What it does |
|---|---|---|
| Image | Image | When any card has no image, every card shows a name tag with its source and origin instead, so the set matches. |
| Image caption | Text | Describes the image. Leave empty to use the name and origin. |
| Ingredient | Text | |
| Dose | Text | As on the label, for example 200 mg (48% DV). |
| Form | Text | |
| Source | Text | Up to the first comma shows large on the name tag, so start with the botanical name, for example: Withania somnifera root, organically grown. |
| Origin | Text | |
| Why it is there | Text | |
| Footnote | Text | Adds a numbered note at the bottom of the page. Use it for sources, sample sizes and claims. |
Lab results
A list of tested batches beside the certificate of analysis of the chosen batch, with a batch code lookup. Batches come from Lab batch blocks, from the Lab batches metafield of the products you choose, or from the store's newest Lab batch entries. With more than three batches the list shows the three newest and a button that opens the rest, labelled with the count, such as 6 batches shown. A batch code typed into the lookup shows that batch's result card in the certificate's place: batch, product, test date, status, results and Open certificate. The certificate shows as a summary with the full certificate one tap away, or in full.
- In the Add section picker
- Lab results (Science)
- Where
- Any template. Not in the header or footer. In the theme as shipped: Home page and Science page.
- Blocks
- Lab batch
- Most blocks
- 12
Settings (18)
| Setting | Type and default | What it does |
|---|---|---|
| Label | Text | Short text above or beside the heading, such as a topic. With Theme settings > Layout > Section numbering on, only headings with a label get a number. |
| Heading | Text | |
| Use the heading as the page title | Checkbox, off by default | Turn on when this is the first section of a page, so the heading is the page's main heading. |
| Heading layout | Options: Left with line above, Left, Full width, Large, Centered, Hidden. Default: Full width | Left aligns with the content below. Full width suits grids. Use Large once a page. Hidden keeps it for screen readers. |
| Show section number | Checkbox, on by default | Shows when Label is set, Heading layout is neither “Centered” nor “Hidden” and Theme settings > Layout > Section numbering is not “Off”. |
| Text | Formatted text | |
| Link label | Text | |
| Link | Link | |
| Batches | ||
| Products | Products | Lists the newest batches from each product's Lab batches field. Leave empty to list the store's own lab batches: it shows the newest of your 50 most recent batches. Lab batch blocks replace this list. |
| Batches to list | 1 to 12, default 6 | With more than three, the list shows the three newest and an All batches button. Without products, it uses the newest of your 50 most recent batches. |
| Certificate | Options: Summary, full certificate on request; Full certificate. Default: Summary, full certificate on request | The summary shows the test date, status and how each test panel came out, with the full certificate one tap away. |
| Show batch lookup | Checkbox, on by default | Shoppers enter the code from their package to open its certificate. The lookup searches every lab batch in the store. |
| Caption | Text | Shown under the certificate. |
| Section | ||
| Anchor link | Text | Lets a menu link jump to this section, for example /pages/science#lab-results. Use lowercase letters and hyphens. |
| Color scheme | Color scheme, default Scheme 4 | |
| Certificate color scheme | Color scheme, default Scheme 2 | A light scheme keeps the certificate readable like a printed report on a dark section. |
| Padding | ||
| Top padding | 0 to 160 px, default 96 px | When the background color changes between two sections, each keeps at least 64px of space, whatever this setting says. |
| Bottom padding | 0 to 160 px, default 96 px | When the background color changes between two sections, each keeps at least 64px of space, whatever this setting says. |
Lab batch
One batch, chosen by its batch code as printed on the package.
- Kind
- Only inside Lab results.
Settings (1)
| Setting | Type and default | What it does |
|---|---|---|
| Batch code | Text | As printed on the package, for example MG-24118. The batch must exist in Content > Metaobjects > Lab batch. |
Results timeline
What to expect over time, as steps on a timeline. Steps come from a product's Timeline metafield, or from Timeline step blocks.
- In the Add section picker
- Results timeline (Science)
- Where
- Any template. Not in the header or footer.
- Blocks
- Timeline step
- Most blocks
- 8
Settings (15)
| Setting | Type and default | What it does |
|---|---|---|
| Label | Text | Short text above or beside the heading, such as a topic. With Theme settings > Layout > Section numbering on, only headings with a label get a number. |
| Heading | Text | |
| Heading layout | Options: Left with line above, Left, Full width, Large, Stacked, Centered, Hidden. Default: Full width | Left aligns with the content below. Full width suits grids. Use Large once a page. Hidden keeps it for screen readers. |
| Show section number | Checkbox, on by default | Shows when Label is set, Heading layout is neither “Centered” nor “Hidden” and Theme settings > Layout > Section numbering is not “Off”. |
| Text | Formatted text | |
| Link label | Text | |
| Link | Link | |
| Steps | ||
| Product | Product | Shows the steps in the product's Timeline metafield. When it has none, the Timeline step blocks show. On a product page, leave empty to use that product. |
| Current step | 1 to 8, default 1 | Steps after this one are muted. With motion allowed, the line fills as shoppers scroll. |
| Note under the timeline | Text | |
| Footnote | Text | Adds a numbered note at the bottom of the page. Use it for sources, sample sizes and claims. Shows when Note under the timeline is set. |
| Section | ||
| Anchor link | Text | Lets a menu link jump to this section, for example /pages/science#lab-results. Use lowercase letters and hyphens. |
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 96 px | When the background color changes between two sections, each keeps at least 64px of space, whatever this setting says. |
| Bottom padding | 0 to 160 px, default 96 px | When the background color changes between two sections, each keeps at least 64px of space, whatever this setting says. |
Timeline step
One step: time label, heading, text and footnote.
- Kind
- Only inside Results timeline.
Settings (4)
| Setting | Type and default | What it does |
|---|---|---|
| Time label | Text | |
| Heading | Text | |
| Text | Text | |
| Footnote | Text | Adds a numbered note at the bottom of the page. Use it for sources, sample sizes and claims. |
Social proof
Figures, comparisons, survey results and quotes.
Comparison table
A table that compares your product with up to two other columns, one Comparison row block per row. Your column is highlighted, and every mark has a text equivalent. On phones the table stacks, so nothing scrolls sideways.
- In the Add section picker
- Comparison table (Social proof)
- Where
- Any template. Not in the header or footer.
- Blocks
- Comparison row
- Most blocks
- 16
Settings (20)
| Setting | Type and default | What it does |
|---|---|---|
| Label | Text | Short text above or beside the heading, such as a topic. With Theme settings > Layout > Section numbering on, only headings with a label get a number. |
| Heading | Text | |
| Heading layout | Options: Left with line above, Left, Full width, Large, Stacked, Centered, Hidden. Default: Full width | Left aligns with the content below. Full width suits grids. Use Large once a page. Hidden keeps it for screen readers. |
| Show section number | Checkbox, on by default | Shows when Label is set, Heading layout is neither “Centered” nor “Hidden” and Theme settings > Layout > Section numbering is not “Off”. |
| Text | Formatted text | |
| Link label | Text | |
| Link | Link | |
| Columns | ||
| Table caption | Text | Read by screen readers. Leave empty to use the heading. |
| Show caption above the table | Checkbox, off by default | |
| First column heading | Text | |
| Your column | Text | Highlighted. Leave empty to use the store name. |
| Tag above your column | Text | |
| Second column | Text | |
| Third column | Text | Leave empty to compare two columns. |
| Note under the table | Text | Say what you compared and when. |
| Footnote | Text | Adds a numbered note at the bottom of the page. Use it for sources, sample sizes and claims. Shows when Note under the table is set. |
| Section | ||
| Anchor link | Text | Lets a menu link jump to this section, for example /pages/science#lab-results. Use lowercase letters and hyphens. |
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 96 px | When the background color changes between two sections, each keeps at least 64px of space, whatever this setting says. |
| Bottom padding | 0 to 160 px, default 96 px | When the background color changes between two sections, each keeps at least 64px of space, whatever this setting says. |
Comparison row
One row: the feature, then a symbol and text for each column.
- Kind
- Only inside Comparison table.
Settings (8)
| Setting | Type and default | What it does |
|---|---|---|
| Feature | Text | |
| Detail | Text | |
| Your column | ||
| Symbol | Options: Yes, No, Partly, No mark. Default: No mark | Shown in this column |
| Text | Text | A short qualifier after the symbol, for example Third-party, every batch. When no row has one, your column narrows and the symbols are centered. |
| Second column | ||
| Symbol | Options: Yes, No, Partly, No mark. Default: No mark | Shown in this column |
| Text | Text | |
| Third column | ||
| Symbol | Options: Yes, No, Partly, No mark. Default: No mark | Shows when the section names a third column. |
| Text | Text | |
Figures with sources
Large numbers with what each one measures, the sample it comes from and a footnote for its source (Evidence stat blocks), with an optional note on method.
- In the Add section picker
- Figures with sources (Social proof)
- Where
- Any template. Not in the header or footer.
- Blocks
- Evidence stat
- Most blocks
- 8
Settings (14)
| Setting | Type and default | What it does |
|---|---|---|
| Each figure carries its source: a footnote or a source line under the number. For headline numbers without sources, use Key figures. | ||
| Label | Text | Short text above or beside the heading, such as a topic. With Theme settings > Layout > Section numbering on, only headings with a label get a number. |
| Heading | Text | |
| Heading layout | Options: Left with line above, Left, Full width, Large, Stacked, Centered, Hidden. Default: Full width | Left aligns with the content below. Full width suits grids. Use Large once a page. Hidden keeps it for screen readers. |
| Show section number | Checkbox, on by default | Shows when Label is set, Heading layout is neither “Centered” nor “Hidden” and Theme settings > Layout > Section numbering is not “Off”. |
| Text | Formatted text | |
| Link label | Text | |
| Link | Link | |
| Columns on desktop | Options: 2, 3, 4. Default: 3 | |
| Note under the figures | Text | Say where the figures come from and when they were last updated. |
| Footnote | Text | Adds a numbered note at the bottom of the page. Use it for sources, sample sizes and claims. Shows when Note under the figures is set. |
| Section | ||
| Anchor link | Text | Lets a menu link jump to this section, for example /pages/science#lab-results. Use lowercase letters and hyphens. |
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 96 px | When the background color changes between two sections, each keeps at least 64px of space, whatever this setting says. |
| Bottom padding | 0 to 160 px, default 96 px | When the background color changes between two sections, each keeps at least 64px of space, whatever this setting says. |
Evidence stat
One figure: number, unit, what it measures, what it is based on and a footnote.
- Kind
- Only inside Figures with sources.
Settings (6)
| Setting | Type and default | What it does |
|---|---|---|
| Use figures you can source, and name the source in the footnote. Without a figure, a long dash shows. | ||
| Figure | Text | Plain numbers such as 120 or 4.8 count up when shoppers scroll to them. |
| Unit | Text | |
| What it measures | Text | |
| Based on | Text | What the figure covers, such as how many people were asked and when. |
| Footnote | Text | The source of the figure. Listed in the notes at the end of the page. |
| Use the accent color | Checkbox, off by default | |
Key figures
A row of large numbers, one Key figure block each, such as servings, doses or customers served. A figure without a number is hidden on the store and shows a sample in the theme editor. The About page template uses it.
- In the Add section picker
- Key figures (Social proof)
- Where
- Any template. Not in the header or footer. In the theme as shipped: About page.
- Blocks
- Key figure
- Most blocks
- 4
Settings (12)
| Setting | Type and default | What it does |
|---|---|---|
| Add up to four figures, each counting something customers can check. A figure without a number is hidden on the store and shows a sample in the editor. | ||
| Label | Text | Short text above or beside the heading, such as a topic. With Theme settings > Layout > Section numbering on, only headings with a label get a number. |
| Heading | Text | With the heading layout set to hidden, the heading is still read out by screen readers. |
| Heading layout | Options: Full width, Hidden. Default: Hidden | Full width suits grids. Hidden keeps it for screen readers. |
| Show section number | Checkbox, on by default | Shows when Label is set, Heading layout is not “Hidden” and Theme settings > Layout > Section numbering is not “Off”. |
| Text | Formatted text | Shows when Heading layout is not “Hidden”. |
| Link label | Text | Shows when Heading layout is not “Hidden”. |
| Link | Link | Shows when Heading layout is not “Hidden”. |
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 0 px | |
| Bottom padding | 0 to 160 px, default 0 px | |
| Show divider above | Checkbox, on by default | |
| Show divider below | Checkbox, on by default | |
Outcomes
Results of a customer survey as a bar chart, always labeled as self-reported, beside up to six customer quotes. The Survey chart block holds the chart's heading, sample size, method note and its Outcome rows.
- In the Add section picker
- Outcomes (Social proof)
- Where
- Any template. Not in the header or footer.
- Blocks
- Testimonial and Survey chart (built in)
- Most blocks
- 6
Settings (11)
| Setting | Type and default | What it does |
|---|---|---|
| Label | Text | Short text above or beside the heading, such as a topic. With Theme settings > Layout > Section numbering on, only headings with a label get a number. |
| Heading | Text | |
| Heading layout | Options: Left with line above, Left, Full width, Large, Stacked, Centered, Hidden. Default: Full width | Left aligns with the content below. Full width suits grids. Use Large once a page. Hidden keeps it for screen readers. |
| Show section number | Checkbox, on by default | Shows when Label is set, Heading layout is neither “Centered” nor “Hidden” and Theme settings > Layout > Section numbering is not “Off”. |
| Text | Formatted text | |
| Link label | Text | |
| Link | Link | |
| Section | ||
| Anchor link | Text | Lets a menu link jump to this section, for example /pages/science#lab-results. Use lowercase letters and hyphens. |
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 96 px | When the background color changes between two sections, each keeps at least 64px of space, whatever this setting says. |
| Bottom padding | 0 to 160 px, default 96 px | When the background color changes between two sections, each keeps at least 64px of space, whatever this setting says. |
Testimonial
One customer quote, with star rating, name, detail, product, portrait and a From a verified order checkbox.
- Kind
- Only inside Outcomes and Testimonials.
Settings (7)
| Setting | Type and default | What it does |
|---|---|---|
| Quote | Text, several lines | Use the customer's own words, with their permission. |
| Star rating | 0 to 5, default 0 | The rating the customer gave. 0 hides the stars. |
| Name | Text | |
| Detail | Text | For example the product they use. Only state facts you can confirm. |
| Product | Product | |
| Portrait | Image | |
| From a verified order | Checkbox, off by default | Only turn on when the quote comes from a customer whose order you can confirm. Shows Verified order. |
Survey chart
The survey chart: its heading, the product or group surveyed, the number of respondents, the method note and the labels for starting values and results. It holds Outcome row blocks.
- Kind
- Built into Outcomes. You edit its settings, but you can't remove it or add another.
- Takes
- Outcome row
Settings (7)
| Setting | Type and default | What it does |
|---|---|---|
| The chart is always labeled as a self-reported survey. Only show figures from a survey you ran, and say how in the method note. Add an Outcome row for each answer you report. | ||
| Chart heading | Text | |
| Product or group surveyed | Text | For example the product name. |
| Number of respondents | Number | Shown as n = 120. |
| Method note | Text | Who was asked, when and how. Shown as a footnote. |
| Label for starting values | Text | Used when a row has a starting value. Leave empty to use Before. |
| Label for results | Text | Leave empty to use After. |
| Caption under the chart | Text | For example: Self-reported answers. Individual results vary. |
Outcome row
One outcome: what was measured, the result as a percentage and an optional starting value.
- Kind
- Only inside Survey chart.
Settings (3)
| Setting | Type and default | What it does |
|---|---|---|
| Outcome | Text | |
| Result | 0 to 100 %, default 50 % | Share of respondents, from your survey. |
| Starting value | Number | Optional. The share at the start of the survey, from 0 to 100. |
Testimonials
Customer quotes as a grid or a scrolling row, with an optional rating summary from a product's review metafields. Takes Testimonial blocks, app blocks and Custom Liquid.
- In the Add section picker
- Testimonials (Social proof)
- Where
- Any template. Not in the header or footer.
- Blocks
- Custom Liquid, app blocks and Testimonial
- Most blocks
- 12
Settings (14)
| Setting | Type and default | What it does |
|---|---|---|
| Label | Text | Short text above or beside the heading, such as a topic. With Theme settings > Layout > Section numbering on, only headings with a label get a number. |
| Heading | Text | |
| Heading layout | Options: Left with line above, Left, Full width, Large, Stacked, Centered, Hidden. Default: Full width | Left aligns with the content below. Full width suits grids. Use Large once a page. Hidden keeps it for screen readers. |
| Show section number | Checkbox, on by default | Shows when Label is set, Heading layout is neither “Centered” nor “Hidden” and Theme settings > Layout > Section numbering is not “Off”. |
| Text | Formatted text | |
| Link label | Text | |
| Link | Link | |
| Rating summary from product | Product | Shows the product's average rating and review count from its rating metafields, which a reviews app fills. Leave empty to hide. |
| Layout | Options: Grid, Carousel. Default: Grid | |
| Columns on desktop | Options: 2, 3. Default: 3 | |
| Section | ||
| Anchor link | Text | Lets a menu link jump to this section, for example /pages/science#lab-results. Use lowercase letters and hyphens. |
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 96 px | When the background color changes between two sections, each keeps at least 64px of space, whatever this setting says. |
| Bottom padding | 0 to 160 px, default 96 px | When the background color changes between two sections, each keeps at least 64px of space, whatever this setting says. |
Text
Text, questions, logos and scrolling phrases.
FAQ
Questions and answers in an accordion, with a contact prompt beside them. Questions come from FAQ question blocks, or from the FAQ metafield of the page or of a product. Group heading blocks split the questions into topics, such as Orders and shipping, so one section holds the whole page and one set of FAQ structured data for search engines.
- In the Add section picker
- FAQ (Text)
- Where
- Any template. Not in the header or footer. In the theme as shipped: Science page and FAQ page.
- Blocks
- FAQ question and Group heading
- Most blocks
- 50
Settings (18)
| Setting | Type and default | What it does |
|---|---|---|
| Label | Text | Short text above or beside the heading, such as a topic. With Theme settings > Layout > Section numbering on, only headings with a label get a number. |
| Heading | Text | |
| Heading layout | Options: Left with line above, Left, Full width, Large, Stacked, Centered, Hidden. Default: Full width | Left aligns with the content below. Full width suits grids. Use Large once a page. Hidden keeps it for screen readers. |
| Show section number | Checkbox, on by default | Questions are numbered after the section number, such as 3.1. Shows when Label is set, Heading layout is neither “Centered” nor “Hidden” and Theme settings > Layout > Section numbering is not “Off”. |
| Text | Formatted text | |
| Layout | Options: Two columns, Stacked. Default: Two columns | |
| Questions | ||
| Source | Options: Blocks, Page metafield, Product metafield. Default: Blocks | A page or product's FAQ metafield lists questions and answers. When it is empty, the blocks are used. |
| Product | Product | Used when Source is Product metafield. On a product page, the page's product is used when this is empty. |
| Open the first question | Checkbox, off by default | Applies to questions from a metafield. For blocks, use each block's Open by default setting. Shows when Source is not “Blocks”. |
| Add FAQ structured data | Checkbox, on by default | Helps search engines show the questions. Use one FAQ section per page with this on: group its questions with Group heading blocks instead of adding sections. |
| Contact prompt | ||
| Heading | Text | |
| Text | Text | |
| Link label | Text | |
| Link | Link | Leave empty to use the page at /pages/contact, or the store's email address. |
| Section | ||
| Anchor link | Text | Lets a menu link jump to this section, for example /pages/science#lab-results. Use lowercase letters and hyphens. |
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 96 px | When the background color changes between two sections, each keeps at least 64px of space, whatever this setting says. |
| Bottom padding | 0 to 160 px, default 96 px | When the background color changes between two sections, each keeps at least 64px of space, whatever this setting says. |
FAQ question
One question and its answer.
- Kind
- Only inside FAQ.
Settings (3)
| Setting | Type and default | What it does |
|---|---|---|
| Question | Text | |
| Answer | Formatted text | |
| Open by default | Checkbox, off by default |
Group heading
A topic heading between questions, such as Orders and shipping. The questions after it, up to the next group heading, belong to it.
- Kind
- Only inside FAQ.
Settings (1)
| Setting | Type and default | What it does |
|---|---|---|
| Heading | Text | The questions after this block, up to the next group heading, are listed under it. |
Logo list
Logos of press, retailers or certifiers in a row, or with a quote each (Press quotes preset). One Logo block per logo.
- In the Add section picker
- Logo list (Text), Press quotes (Text)
- Where
- Any template. Not in the header or footer.
- Blocks
- Logo
- Most blocks
- 12
Settings (15)
| Setting | Type and default | What it does |
|---|---|---|
| Layout | Options: Logos in a row, Quotes with logos. Default: Logos in a row | |
| Columns on desktop | 2 to 6, default 5 | |
| Logo height | 24 to 96 px, default 40 px | |
| Show logos in one color | Checkbox, on by default | Removes color from logo images. On dark color schemes the logos are also inverted, so use logos on a transparent background. |
| Heading | ||
| Label | Text | Short text above or beside the heading, such as a topic. With Theme settings > Layout > Section numbering on, only headings with a label get a number. |
| Heading | Text | |
| Heading layout | Options: Full width, Hidden. Default: Full width | Full width suits grids. Hidden keeps it for screen readers. |
| Show section number | Checkbox, on by default | Shows when Label is set, Heading layout is not “Hidden” and Theme settings > Layout > Section numbering is not “Off”. |
| Text | Formatted text | |
| Link label | Text | |
| Link | Link | |
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 64 px | |
| Bottom padding | 0 to 160 px, default 64 px | |
| Show divider above | Checkbox, off by default | |
Logo
One logo with a name, link and optional quote.
- Kind
- Only inside Logo list.
Settings (4)
| Setting | Type and default | What it does |
|---|---|---|
| Logo image | Image | Use a .png or .svg file with a transparent background. |
| Name | Text | Used as the logo's alternative text, and shown as text when there is no image. |
| Link | Link | |
| Quote | Text, several lines | Shown in the quotes layout. Only use quotes you have permission to share. |
Multicolumn
Columns of image, heading and text, one Column block each, or rows like a specification table (Specification list preset).
- In the Add section picker
- Multicolumn (Text), Specification list (Text)
- Where
- Any template. Not in the header or footer. In the theme as shipped: About page.
- Blocks
- Column
- Most blocks
- 12
Settings (15)
| Setting | Type and default | What it does |
|---|---|---|
| Layout | Options: Columns; Rows, like a specification table. Default: Columns | |
| Columns on desktop | 2 to 4, default 3 | Shows when Layout is “Columns”. |
| Number the entries | Checkbox, on by default | |
| Image ratio | Options: Square, 1:1; Portrait, 4:5; Landscape, 3:2. Default: Landscape, 3:2 | Applies to images added to the entries. Shows when Layout is “Columns”. |
| Heading | ||
| Label | Text | Short text above or beside the heading, such as a topic. With Theme settings > Layout > Section numbering on, only headings with a label get a number. |
| Heading | Text | |
| Heading layout | Options: Left with line above, Left, Full width, Hidden. Default: Full width | Left aligns with the content below. Full width suits grids. Hidden keeps it for screen readers. |
| Show section number | Checkbox, on by default | Shows when Label is set, Heading layout is not “Hidden” and Theme settings > Layout > Section numbering is not “Off”. |
| Text | Formatted text | |
| Link label | Text | |
| Link | Link | |
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 96 px | |
| Bottom padding | 0 to 160 px, default 96 px | |
| Show divider above | Checkbox, off by default | |
Column
One column: image, heading, text, figure and link.
- Kind
- Only inside Multicolumn.
Settings (6)
| Setting | Type and default | What it does |
|---|---|---|
| Image | Image | Optional. Images show in the columns layout only. |
| Heading | Text | |
| Text | Formatted text | |
| Figure | Text | A dose, a count or a time, set in the data type, for example 200 mg. |
| Link label | Text | |
| Link | Link |
Rich text
Headings, text and buttons from any theme blocks, stacked or with the heading beside the text.
- In the Add section picker
- Rich text (Text), Rich text with side heading (Text)
- Where
- Any template. Not in the header or footer. In the theme as shipped: About page.
- Blocks
- Heading, Text, Button, Image, Icon with text, List item, Key figure, Group, Divider, Spacer, Custom Liquid and app blocks
Settings (8)
| Setting | Type and default | What it does |
|---|---|---|
| Layout | Options: Stacked, Heading beside the text. Default: Stacked | With the heading beside the text, the first block sits in the left column on desktop. |
| Alignment | Options: Left, Center. Default: Left | Shows when Layout is “Stacked”. |
| Content width | Options: Narrow, Medium, Wide. Default: Medium | Shows when Layout is “Stacked”. |
| Line above the text | Checkbox, off by default | |
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 96 px | |
| Bottom padding | 0 to 160 px, default 96 px | |
| Show divider above | Checkbox, off by default | |
Scrolling text
Phrases that scroll across the page, one Phrase block each, with a separator, speed and direction. It stops moving for visitors who turn on reduced motion.
- In the Add section picker
- Scrolling text (Text)
- Where
- Any template. Not in the header or footer.
- Blocks
- Phrase
- Most blocks
- 12
Settings (9)
| Setting | Type and default | What it does |
|---|---|---|
| Text style | Options: Large headline, Small label. Default: Large headline | |
| Separator | Options: Dot, Slash, Short line, None. Default: Dot | |
| Speed | Options: Slow, Medium, Fast. Default: Medium | Visitors can pause the text. It stays still for visitors who reduce motion. |
| Direction | Options: Left, Right. Default: Left | |
| Lines above and below the text | Checkbox, on by default | |
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 0 px | |
| Bottom padding | 0 to 160 px, default 0 px | |
| Show divider above | Checkbox, off by default | |
Phrase
One phrase, with an optional link.
- Kind
- Only inside Scrolling text.
Settings (2)
| Setting | Type and default | What it does |
|---|---|---|
| Text | Text | |
| Link | Link |
Forms
Email signup.
Contact form
A contact form with name, email and message, optional phone and order number fields, and Contact detail blocks beside it.
- In the Add section picker
- Contact form (Forms)
- Where
- Any template. Not in the header or footer. In the theme as shipped: Contact page.
- Blocks
- app blocks, Custom Liquid and Contact detail
Settings (10)
| Setting | Type and default | What it does |
|---|---|---|
| Label | Text | Short text above or beside the heading, such as a topic. With Theme settings > Layout > Section numbering on, only headings with a label get a number. |
| Heading | Text | |
| Text | Formatted text | |
| Form fields | ||
| Show phone number field | Checkbox, on by default | |
| Show order number field | Checkbox, on by default | |
| Message help text | Text | Shown under the message field. Leave blank to use the default text. |
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 48 px | |
| Bottom padding | 0 to 160 px, default 96 px | |
| Show divider above | Checkbox, off by default | |
Contact detail
One contact detail, such as email, phone or address, or your own text.
- Kind
- Only inside Contact form.
Settings (6)
| Setting | Type and default | What it does |
|---|---|---|
| Show | Options: Store email, Store phone, Store address, Opening hours, Custom. Default: Custom | Email, phone and address come from your store details in Shopify admin. |
| Icon | Options: Chat, Question, Delivery, Returns, Lab, Calendar. Default: Chat | Shows when Show is “Custom”. |
| Heading | Text | Leave blank to use the default for the type. |
| Text | Formatted text | |
| Link label | Text | |
| Link | Link |
Email signup
An email signup form that adds subscribers to your Shopify customers, with text under the form and a link to your privacy policy.
- In the Add section picker
- Email signup (Forms)
- Where
- Any template. Not in the header or footer.
Settings (11)
| Setting | Type and default | What it does |
|---|---|---|
| Signups are added to your customer list with the "newsletter" tag and accept email marketing. | ||
| Label | Text | Short text above or beside the heading, such as a topic. With Theme settings > Layout > Section numbering on, only headings with a label get a number. |
| Heading | Text | |
| Heading layout | Options: Left with line above, Left, Centered, Hidden. Default: Centered | Left aligns with the content below. Centered suits a closing call to action. Hidden keeps it for screen readers. |
| Show section number | Checkbox, off by default | Shows when Label is set, Heading layout is neither “Centered” nor “Hidden” and Theme settings > Layout > Section numbering is not “Off”. |
| Text | Formatted text | |
| Text under the form | Formatted text | Say how often you send email. The link to your privacy policy follows it. |
| Link to your privacy policy | Checkbox, on by default | Uses the privacy policy in Settings > Policies. Nothing shows until you add one. |
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 96 px | |
| Bottom padding | 0 to 160 px, default 96 px | |
| Show divider above | Checkbox, off by default | |
Blog
Articles on any page.
Blog posts
Recent articles from one blog, as a grid or a lead story, with optional images, excerpts, author and date.
- In the Add section picker
- Blog posts (Blog)
- Where
- Any template. Not in the header or footer. In the theme as shipped: Home page.
Settings (19)
| Setting | Type and default | What it does |
|---|---|---|
| Blog | Blog | Leave empty to show the News blog that every store starts with. |
| Layout | Options: Grid, Lead story. Default: Lead story | Lead story puts the newest article beside the heading, with the next articles in a row below. |
| Articles to show | 2 to 8, default 4 | |
| Columns on desktop | 2 to 4, default 3 | Shows when Layout is “Grid”. |
| Show images | Checkbox, on by default | |
| Show excerpt | Checkbox, on by default | |
| Show author | Checkbox, on by default | |
| Show date | Checkbox, on by default | |
| Heading | ||
| Label | Text | Short text above or beside the heading, such as a topic. With Theme settings > Layout > Section numbering on, only headings with a label get a number. |
| Heading | Text | |
| Heading layout | Options: Full width, Stacked, Hidden. Default: Full width | Full width suits grids. Stacked keeps the heading in the content column. Hidden keeps it for screen readers. |
| Show section number | Checkbox, on by default | Shows when Label is set, Heading layout is not “Hidden” and Theme settings > Layout > Section numbering is not “Off”. |
| Text | Formatted text | Shows when Heading layout is not “Hidden”. |
| Link label | Text | Shows when Heading layout is not “Hidden”. |
| Link | Link | Leave empty to link to the blog. Shows when Heading layout is not “Hidden”. |
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 80 px | |
| Bottom padding | 0 to 160 px, default 80 px | |
| Show divider above | Checkbox, off by default | |
Layout
Blank sections you build from blocks, and your own code.
Custom Liquid
Your own Liquid or HTML as a section, for embeds and code from apps.
- In the Add section picker
- Custom Liquid (Layout)
- Where
- Any template. Not in the header or footer.
Settings (6)
| Setting | Type and default | What it does |
|---|---|---|
| Liquid code | Liquid code | Add app snippets or other code to make advanced customizations. |
| Use the full page width | Checkbox, off by default | |
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 48 px | |
| Bottom padding | 0 to 160 px, default 48 px | |
| Show divider above | Checkbox, off by default | |
Section
A blank section you build from any theme blocks and app blocks, stacked or side by side, with an optional background image.
- In the Add section picker
- Blank section (Layout), Two columns (Layout), Banner with background (Layout)
- Where
- Any template. Not in the header or footer.
- Blocks
- any theme block and app blocks
Settings (12)
| Setting | Type and default | What it does |
|---|---|---|
| Arrange blocks | Options: Stacked, Side by side. Default: Stacked | Side by side applies from tablet width. Use group blocks to build each column. |
| Content width | Options: Narrow, Page width, Full width. Default: Page width | |
| Horizontal alignment | Options: Left, Center, Right. Default: Left | |
| Vertical alignment | Options: Top, Middle, Bottom. Default: Top | |
| Space between blocks | 0 to 96 px, default 24 px | |
| Minimum height | Options: Fit content, Small, Medium, Large. Default: Fit content | |
| Background | ||
| Background image | Image | Set the focal point in the image editor to control the crop. |
| Image tint | 0 to 90 %, default 45 % | Tints the image with the color scheme's background color. Lower values show more of the image but can leave text unreadable over bright photos. Shows when Background image is set. |
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 96 px | |
| Bottom padding | 0 to 160 px, default 96 px | |
| Show divider above | Checkbox, off by default | |
Product page
The sections of the product template.
Product details
Product details: the chapters under the buy box, such as Supplement Facts, Compliance disclaimer, Ingredients (product), How to take, Lab results (product), Reviews and FAQ (product). Each chapter reads the product's metaobject entry, else its own settings, which can connect to product fields, and hides when it has nothing. A chapter with one item shows as a row in one Specifications table, which also lists the product's category fields; when How to take is such a row, its safety note prints under the table. A product with none of this data, such as a shirt, gets a Specifications table of its category, type, vendor (when it differs from the store name) when it has two rows. Show category, type and vendor controls those rows; Include product options is off by default. A lone Specifications chapter has no number. In the theme editor, one Product data notice counts blocks with content, explains shared template text, and keeps next steps in a closed Show blocks disclosure.
- In the Add section picker
- Product details (Products)
- Where
- Only on product templates. In the theme as shipped: Default product and Bundle product.
Settings (7)
| Setting | Type and default | What it does |
|---|---|---|
| Show category, type and vendor | Checkbox, on by default | Adds a Specifications table from the product’s standard fields when no product data block has content. |
| Include product options | Checkbox, off by default | The variant picker already lists them. Shows when Show category, type and vendor is on. |
| Color scheme | Color scheme, default Scheme 1 | |
| Space between blocks | 32 to 160 px, default 72 px | |
| Padding | ||
| Top padding | 0 to 160 px, default 96 px | |
| Bottom padding | 0 to 160 px, default 96 px | |
| Show divider above | Checkbox, off by default | |
Product information
The gallery and buy box of the product page. It holds the product blocks (title, price, variant picker, purchase options, buy buttons and more) and app blocks, with an optional page index bar and a sticky add to cart bar. The gallery shows the selected variant's image first.
- In the Add section picker
- Product information. Listed first, without a category.
- Where
- Only on product templates. In the theme as shipped: Default product and Bundle product.
- Blocks
- any theme block and app blocks
Settings (16)
| Setting | Type and default | What it does |
|---|---|---|
| Layout | ||
| Desktop layout | Options: Wide media, Equal columns. Default: Wide media | |
| Media position on desktop | Options: Left, Right. Default: Left | |
| Keep product details in view while scrolling | Checkbox, on by default | Desktop. Product details stay in view while the gallery scrolls. Details taller than the screen stick by their bottom edge. |
| Show breadcrumbs | Checkbox, on by default | |
| Media | ||
| Gallery layout | Options: Stacked figures, Thumbnails. Default: Stacked figures | Stacked shows every media as a figure; two media share a row only when they have the same shape. On mobile, both layouts become a swipe carousel with a counter. |
| Media shape | Options: Natural, Square, Portrait. Default: Natural | Natural keeps each image's own shape, so nothing is cropped. |
| Media fit | Options: Fit inside, Fill and crop. Default: Fit inside | Shows when Media shape is not “Natural”. |
| Show figure captions | Checkbox, off by default | Uses each image’s alt text as its figure caption. Leave off when alt text is written only for screen readers. |
| Open images in a zoom view | Checkbox, on by default | |
| Loop videos | Checkbox, off by default | |
| Sticky bars | ||
| Show page index bar | Checkbox, on by default | Desktop. Shows under the header whenever the add to cart button is out of view, with links to the sections below, the price and an add to cart button. |
| Show sticky add to cart bar | Checkbox, on by default | Mobile. Shows at the bottom of the screen whenever the add to cart button is out of view, with the image, title, selected option and price. |
| Color scheme | ||
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 24 px | |
| Bottom padding | 0 to 160 px, default 64 px | |
| Show divider above | Checkbox, off by default | |
Related products
One rail of products: the complementary products you choose in the Search and Discovery app first, tagged Pairs with, then the related products Shopify picks, without duplicates. One or two products show as wide cards. It loads as the shopper scrolls near it and stays hidden when there are none.
- In the Add section picker
- Related products (Products)
- Where
- Only on product templates. In the theme as shipped: Default product and Bundle product.
Settings (13)
| Setting | Type and default | What it does |
|---|---|---|
| Complementary products you choose in the Search and Discovery app come first, tagged Pairs with, then the related products Shopify picks. Hidden when there are none. | ||
| Heading | Text | |
| Heading layout | Options: Left with line above, Left, Full width, Centered, Hidden. Default: Full width | Left aligns with the content below. Full width suits grids. Hidden keeps it for screen readers. |
| Text | Formatted text | |
| Link label | Text | |
| Link | Link | |
| Products | ||
| Maximum products to show | 2 to 10, default 4 | |
| Columns on desktop | 2 to 5, default 4 | |
| Layout on mobile | Options: Swipe row, Grid. Default: Swipe row | |
| Columns on mobile | Options: 1 column, 2 columns. Default: 2 columns | Shows when Layout on mobile is “Grid”. |
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 96 px | |
| Bottom padding | 0 to 160 px, default 96 px | |
| Show divider above | Checkbox, off by default | |
Page templates
Sections that make up a template. Most can only be used on their own template.
Activate account
The page where a customer activates an account and sets a password.
- Where
- Part of the Activate account template. It is not in the Add section picker, so it can't be added elsewhere.
Settings (4)
| Setting | Type and default | What it does |
|---|---|---|
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 64 px | |
| Bottom padding | 0 to 160 px, default 96 px | |
| Show divider above | Checkbox, off by default | |
All collections
The page that lists all collections, as cards with images, product counts and descriptions.
- Where
- Part of the Collections list template. It is not in the Add section picker, so it can't be added elsewhere.
Settings (13)
| Setting | Type and default | What it does |
|---|---|---|
| Show breadcrumbs | Checkbox, on by default | |
| Heading | Text | Leave blank to use the translated word "Collections". |
| Text | Formatted text | |
| Grid | ||
| Collections per page | 6 to 48, default 24 | |
| Columns on desktop | 2 to 4, default 3 | |
| Columns on mobile | Options: 1, 2. Default: 2 | |
| Image ratio | Options: Square, 1:1; Portrait, 4:5; Landscape, 3:2. Default: Portrait, 4:5 | |
| Show product count | Checkbox, on by default | |
| Show description excerpt | Checkbox, on by default | |
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 24 px | |
| Bottom padding | 0 to 160 px, default 96 px | |
| Show divider above | Checkbox, off by default | |
Article
The blog post template: title, byline with author and reviewer, dates, reading time, featured image, table of contents, share links, author bio, products mentioned, related articles and comments.
- In the Add section picker
- Article. Listed first, without a category.
- Where
- Only on blog post templates. In the theme as shipped: Blog post.
- Blocks
- app blocks and Custom Liquid
Settings (25)
| Setting | Type and default | What it does |
|---|---|---|
| Show breadcrumbs | Checkbox, on by default | |
| Show excerpt below the title | Checkbox, on by default | Shows the article excerpt under the title. |
| Byline | ||
| Show author | Checkbox, on by default | Uses the entry in the article’s Author metafield when it is set, otherwise the staff account that wrote the article. |
| Show reviewer | Checkbox, on by default | |
| Reviewer name | Text | Used when an article has no entry in its Reviewed by metafield. Connect a metafield here to set it per article. Shows when Show reviewer is on. |
| Reviewer credentials | Text | Shows when Show reviewer is on. |
| Show dates | Checkbox, on by default | |
| Show reading time | Checkbox, on by default | Estimated at 220 words per minute. |
| Image | ||
| Show featured image | Checkbox, on by default | |
| Image ratio | Options: Natural; Landscape, 3:2; Wide, 16:9. Default: Wide, 16:9 | Shows when Show featured image is on. |
| Show caption | Checkbox, on by default | Uses the image's alt text. Shows when Show featured image is on. |
| Reading tools | ||
| Show table of contents | Checkbox, on by default | Built from the article's headings. Shows when there are at least two. |
| Headings to list | Options: Main headings, Main headings and subheadings. Default: Main headings | Shows when Show table of contents is on. |
| Show share links | Checkbox, on by default | |
| Show author bio | Checkbox, on by default | Shown when the author has a bio, a role or credentials. |
| Products mentioned | ||
| Heading | Text | Leave blank to use “Products mentioned”. |
| Products | Products | Leave empty to use the products in the article’s Related products metafield. |
| Related articles | ||
| Heading | Text | Leave blank to use “Keep reading”. |
| Number of articles | 0 to 3, default 3 | Articles that share a tag with this one come first. |
| Comments | ||
| Show comments | Checkbox, on by default | Comments also need to be turned on for the blog in Shopify admin. |
| Comments per page | 5 to 50, default 10 | Shows when Show comments is on. |
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 40 px | |
| Bottom padding | 0 to 160 px, default 96 px | |
| Show divider above | Checkbox, off by default | |
Blog
The blog template: an introduction, a topic filter built from article tags, and the articles, with the newest one optionally featured.
- In the Add section picker
- Blog. Listed first, without a category.
- Where
- Only on blog templates. In the theme as shipped: Blog.
Settings (15)
| Setting | Type and default | What it does |
|---|---|---|
| Show breadcrumbs | Checkbox, on by default | |
| Label | Text | Small text above the title. Leave blank to show the number of articles. |
| Introduction | Formatted text | Shows under the blog title. One or two sentences that tell readers what the blog covers. |
| Show topic filter | Checkbox, on by default | Lists the tags used on the blog's articles as links. |
| Articles | ||
| Layout | Options: Grid, List. Default: Grid | |
| Feature the newest article | Checkbox, on by default | Shows the first article large on the first page. |
| Articles per page | 3 to 24, default 10 | |
| Show images | Checkbox, on by default | |
| Show excerpts | Checkbox, on by default | |
| Show author | Checkbox, on by default | |
| Show date | Checkbox, on by default | |
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 40 px | |
| Bottom padding | 0 to 160 px, default 96 px | |
| Show divider above | Checkbox, off by default | |
Cart
The cart page: cart lines with suggested products under them, headed by the section's Heading (Add to your order unless you change it), and an order summary with free shipping progress, discounts, the estimated total, checkout buttons and the order note.
- Where
- Part of the Cart template. It is not in the Add section picker, so it can't be added elsewhere.
- Blocks
- app blocks and Custom Liquid
Settings (7)
| Setting | Type and default | What it does |
|---|---|---|
| Show accelerated checkout buttons | Checkbox, on by default | Shows the wallets turned on in Settings > Payments, such as Shop Pay and Apple Pay. |
| Goal links in the empty cart come from Theme settings > Goals. | ||
| Goal list heading | Text | Leave blank for "Shop by goal", or "Shop by collection" while no goals are chosen. |
| Recommendations | ||
| Heading | Text | Shown over the products suggested under the cart lines. Turn suggestions on or off in Theme settings > Cart. Shows when Theme settings > Cart > Show recommendations is on. |
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 40 px | |
| Bottom padding | 0 to 160 px, default 96 px | |
| Show divider above | Checkbox, off by default | |
Collection banner
The top of a collection page: breadcrumbs, the collection title, description and image, and optional Statistic blocks, such as the number of products.
- In the Add section picker
- Collection banner. Listed first, without a category.
- Where
- Only on collection templates. In the theme as shipped: Default collection.
- Blocks
- Statistic
Settings (9)
| Setting | Type and default | What it does |
|---|---|---|
| Show breadcrumbs | Checkbox, on by default | |
| Emphasized words | Text | Set these words of the collection title in italic. Separate them with commas; each must match a word in the title exactly. |
| Show collection description | Checkbox, on by default | |
| Show collection image | Checkbox, on by default | Uses the image set on the collection in Shopify admin. |
| Image ratio | Options: Natural; Square, 1:1; Portrait, 4:5; Landscape, 3:2; Wide, 16:9. Default: Landscape, 3:2 | On large screens tall images are cropped so products stay near the top of the page. Shows when Show collection image is on. |
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 24 px | |
| Bottom padding | 0 to 160 px, default 0 px | |
| Show divider above | Checkbox, off by default | |
Statistic
A figure beside the collection title: a value you type, or the number of products in the collection.
- Kind
- Only inside Collection banner.
Settings (3)
| Setting | Type and default | What it does |
|---|---|---|
| Show | Options: Custom value, Number of products. Default: Custom value | |
| Value | Text | A figure customers can check. Leave blank to show a dash, or choose "Number of products" to count them. Shows when Show is “Custom value”. |
| Label | Text |
Customer account
The customer account page with the order history and a subscriptions card. The card links to Theme settings > Subscriptions > Subscription management link when it is set.
- Where
- Part of the Customer account template. It is not in the Add section picker, so it can't be added elsewhere.
- Blocks
- app blocks and Custom Liquid
Settings (7)
| Setting | Type and default | What it does |
|---|---|---|
| Orders per page | 5 to 25, default 10 | |
| Subscriptions card | ||
| Heading | Text | |
| Text | Formatted text | |
| The "Manage subscriptions" link comes from Theme settings > Subscriptions > Subscription management link. Without it, the card tells customers to use the link in their subscription emails. | ||
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 48 px | |
| Bottom padding | 0 to 160 px, default 96 px | |
| Show divider above | Checkbox, off by default | |
Customer addresses
A customer's saved addresses, with forms to add, edit and delete them.
- Where
- Part of the Customer addresses template. It is not in the Add section picker, so it can't be added elsewhere.
Settings (4)
| Setting | Type and default | What it does |
|---|---|---|
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 48 px | |
| Bottom padding | 0 to 160 px, default 96 px | |
| Show divider above | Checkbox, off by default | |
Customer login
Customer sign-in, with the password recovery form.
- Where
- Part of the Customer login template. It is not in the Add section picker, so it can't be added elsewhere.
Settings (5)
| Setting | Type and default | What it does |
|---|---|---|
| Intro text | Text | Leave blank to use the default text. |
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 64 px | |
| Bottom padding | 0 to 160 px, default 96 px | |
| Show divider above | Checkbox, off by default | |
Customer order
One order in the customer account, with an Order again button.
- Where
- Part of the Customer order template. It is not in the Add section picker, so it can't be added elsewhere.
- Blocks
- app blocks and Custom Liquid
Settings (5)
| Setting | Type and default | What it does |
|---|---|---|
| Show order again button | Checkbox, on by default | Adds every available item from the order to the cart, with its subscription plan. |
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 48 px | |
| Bottom padding | 0 to 160 px, default 96 px | |
| Show divider above | Checkbox, off by default | |
Customer registration
The create account form, with an optional email signup checkbox.
- Where
- Part of the Create account template. It is not in the Add section picker, so it can't be added elsewhere.
Settings (6)
| Setting | Type and default | What it does |
|---|---|---|
| Intro text | Text | Leave blank to use the default text. |
| Show email signup checkbox | Checkbox, on by default | Customers who check it agree to receive marketing emails. |
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 64 px | |
| Bottom padding | 0 to 160 px, default 96 px | |
| Show divider above | Checkbox, off by default | |
Page
The page template's main content: title, label, the page content with its first paragraph as a larger summary, and an optional table of contents built from its headings.
- In the Add section picker
- Page. Listed first, without a category.
- Where
- Only on page templates. In the theme as shipped: Default page, About page, Contact page, Science page and FAQ page.
- Blocks
- app blocks and Custom Liquid
Settings (10)
| Setting | Type and default | What it does |
|---|---|---|
| Show breadcrumbs | Checkbox, on by default | |
| Show page title | Checkbox, on by default | When hidden, the title is still read by screen readers. |
| Show the first paragraph as a summary | Checkbox, on by default | Sets the page's first paragraph under the title in the larger summary size, as on collection and blog pages. Shows when Show page title is on. |
| Label | Text | Short text above or beside the heading, such as a topic. With Theme settings > Layout > Section numbering on, only headings with a label get a number. |
| Show table of contents | Checkbox, on by default | Built from the page's headings and shown beside the text on desktop. Shows when there are at least two. |
| Headings to list | Options: Main headings, Main headings and subheadings. Default: Main headings | Shows when Show table of contents is on. |
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 40 px | |
| Bottom padding | 0 to 160 px, default 96 px | |
| Show divider above | Checkbox, off by default | |
Page not found
The page not found template: a heading, text and your goal links, so shoppers can carry on browsing.
- In the Add section picker
- Page not found. Listed first, without a category.
- Where
- Only on 404 templates. In the theme as shipped: 404 page.
Settings (8)
| Setting | Type and default | What it does |
|---|---|---|
| Heading | Text | Leave blank to use “This page went missing.” |
| Text | Formatted text | Leave blank to use the default text. |
| Figure caption | Text | Shown under the chart. Leave blank to use the default text. |
| Goal links | ||
| Heading | Text | Leave blank for “Shop by goal”, or “Shop by collection” until goals are chosen in Theme settings > Goals. |
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 64 px | |
| Bottom padding | 0 to 160 px, default 96 px | |
| Show divider above | Checkbox, off by default | |
Password page
The password page shown while the store is closed: heading, newsletter signup and image. Visitors with the password enter it in a dialog.
- In the Add section picker
- Password page. Listed first, without a category.
- Where
- Only on password templates. In the theme as shipped: Password.
Settings (11)
| Setting | Type and default | What it does |
|---|---|---|
| Label | Text | Shown above the heading. |
| Heading | Text | Leave blank to use the store name. The message for visitors from Online Store > Preferences shows under the heading. |
| Newsletter | ||
| Show newsletter signup | Checkbox, on by default | |
| Heading | Text | Shows when Show newsletter signup is on. |
| Text | Formatted text | Shows when Show newsletter signup is on. |
| Image | ||
| Image | Image | Optional. Shown beside the signup form. |
| Image caption | Text | Shows when Image is set. |
| Color scheme | Color scheme, default Scheme 1 | |
| Password dialog color scheme | Color scheme, default Scheme 2 | |
| Padding | ||
| Top padding | 0 to 160 px, default 24 px | |
| Bottom padding | 0 to 160 px, default 24 px | |
Product grid
The product grid of a collection: filters, sorting, pagination and a goal navigation row above the grid. Promotion and Routine blocks sit between the products; Custom Liquid and app blocks are also available.
- Where
- Part of the Default collection template. It is not in the Add section picker, so it can't be added elsewhere.
- Blocks
- app blocks, Custom Liquid, Promotion and Routine
- Most blocks
- 10
Settings (17)
| Setting | Type and default | What it does |
|---|---|---|
| Products per page | 8 to 48, default 12 | |
| Columns on desktop | 2 to 4, default 3 | |
| Columns on mobile | Options: 1, 2. Default: 2 | Shows when Theme settings > Product cards > Layout on mobile is not “Rows”. |
| Grid style | Options: Ruled cells, Open. Default: Ruled cells | |
| Pagination | Options: Page numbers, Load more button. Default: Page numbers | |
| Goal navigation | ||
| Goal collections | Collections | Leave empty to use Theme settings > Goals. Shown as a scrolling row above the grid. |
| Navigation name | Text | Read by screen readers. Leave blank to use "Shop by goal". |
| Show "All" link | Checkbox, on by default | |
| Show collection images | Checkbox, on by default | |
| Filtering and sorting | ||
| Enable filtering | Checkbox, on by default | Choose which filters show with the Shopify Search and Discovery app. |
| Filter layout on desktop | Options: Sidebar, Drawer. Default: Sidebar | Shows when Enable filtering is on. |
| Enable sorting | Checkbox, on by default | |
| Show grid and list toggle | Checkbox, on by default | |
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 16 px | |
| Bottom padding | 0 to 160 px, default 96 px | |
| Show divider above | Checkbox, off by default | |
Custom Liquid
Your own Liquid among the products.
- Kind
- Only inside Product grid.
Settings (1)
| Setting | Type and default | What it does |
|---|---|---|
| Liquid code | Liquid code | Add app snippets or other code to make advanced customizations. Shows above the product grid. |
Promotion
A promotion, as a band across the grid or a tile in it, at the position you choose.
- Kind
- Only inside Product grid.
Settings (10)
| Setting | Type and default | What it does |
|---|---|---|
| Layout | Options: Band across the grid, Tile in the grid. Default: Band across the grid | A tile stays one cell only while every row of products stays full. Otherwise it shows as a band. |
| Position in grid | 1 to 24, default 4 | A tile goes before this product, a band after the row that holds it. Promotions show on the first page when no filters are applied. |
| Image | Image | Shows beside the text in the band layout. |
| Label | Text | |
| Heading | Text | |
| Text | Formatted text | |
| Button label | Text | |
| Button link | Link | The promotion shows only when it has a link and a button label. |
| Button style | Options: Primary, Secondary, Text link. Default: Primary | |
| Color scheme | Color scheme, default Scheme 4 |
Routine
A card that suggests a routine of products you pick, at the position you choose.
- Kind
- Only inside Product grid.
Settings (7)
| Setting | Type and default | What it does |
|---|---|---|
| Position in grid | 1 to 24, default 7 | The routine spans the grid after the row that holds this product. It shows on the first page when no filters are applied. |
| Label | Text | |
| Heading | Text | |
| Text | Formatted text | |
| Products | Products | Up to three. Shoppers can add them all to the cart at once. |
| Button label | Text | |
| Color scheme | Color scheme, default Scheme 3 |
Reset password
The form where a customer chooses a new password.
- Where
- Part of the Reset password template. It is not in the Add section picker, so it can't be added elsewhere.
Settings (4)
| Setting | Type and default | What it does |
|---|---|---|
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 64 px | |
| Bottom padding | 0 to 160 px, default 96 px | |
| Show divider above | Checkbox, off by default | |
Search results
The search results page: the search form, result type tabs, products with filters and sorting, articles and pages. A search for a batch code shows that batch's certificate card first.
- Where
- Part of the Search template. It is not in the Add section picker, so it can't be added elsewhere.
- Blocks
- app blocks and Custom Liquid
Settings (16)
| Setting | Type and default | What it does |
|---|---|---|
| Emphasized words | Text | Set these words of the results title in italic. Separate them with commas; each must match a word in the title exactly. |
| Results per page | 8 to 48, default 48 | Each result type shows its count when all results fit on one page. |
| Show result type tabs | Checkbox, on by default | Links that limit the results to products, articles or pages. |
| Products | ||
| Columns on desktop | 2 to 4, default 3 | |
| Columns on mobile | Options: 1, 2. Default: 2 | Shows when Theme settings > Product cards > Layout on mobile is not “Rows”. |
| Enable filtering | Checkbox, on by default | Choose which filters show with the Shopify Search and Discovery app. |
| Filter layout on desktop | Options: Sidebar, Drawer. Default: Sidebar | Shows when Enable filtering is on. |
| Enable sorting | Checkbox, on by default | |
| Articles | ||
| Show article images | Checkbox, on by default | |
| Suggestions | ||
| Suggested searches | Text | Separate searches with commas. Shown before a search and when nothing matches. Leave blank to show the popular searches from Theme settings > Search. |
| Lab results page | Link | Shown as a link above the results when a search asks for lab results or certificates. Leave blank to hide it. |
| Goal links before a search and when nothing matches come from Theme settings > Goals. | ||
| Goal list heading | Text | Leave blank for "Shop by goal", or "Shop by collection" while no goals are chosen. |
| Color scheme | Color scheme, default Scheme 1 | |
| Padding | ||
| Top padding | 0 to 160 px, default 40 px | |
| Bottom padding | 0 to 160 px, default 96 px | |
| Show divider above | Checkbox, off by default | |
Header and footer
The header and footer groups and the footnotes, shared by every page.
Announcement bar
Short messages above the header, one Announcement block each. One at a time rotates the messages, with pause, previous and next buttons; Columns sets them side by side on desktop.
- In the Add section picker
- Announcement bar. Listed first, without a category.
- Where
- Only in the header group. In the theme as shipped: Header.
- Blocks
- Announcement
- Most blocks
- 6
Settings (5)
| Setting | Type and default | What it does |
|---|---|---|
| Color scheme | Color scheme, default Scheme 4 | |
| Layout | Options: One at a time, Columns. Default: One at a time | Columns show every message side by side on desktop and rotate on smaller screens. |
| Rotate messages | Checkbox, on by default | Rotation pauses on hover and focus, and stays off for visitors who prefer reduced motion. |
| Time per message | 4 to 12 s, default 6 s | Shows when Rotate messages is on. |
| Show close button | Checkbox, off by default | Hides the bar for the rest of the visit. |
Announcement
One message in the announcement bar, with an optional link.
- Kind
- Only inside Announcement bar.
Settings (4)
| Setting | Type and default | What it does |
|---|---|---|
| Text | Text | |
| Link | Link | |
| Link label | Text | Shown as a link after the text. Leave empty to make the whole message the link. |
| Style | Options: Plain, Status. Default: Plain | Status adds a pulsing dot before the text. A code in the text, such as a batch number, is set in the data font. |
Footer
The site footer: menu, brand, contact, newsletter, image card, Custom Liquid and app blocks, then an optional wordmark (full width on the home, collection and product pages, one smaller line on every other page) and a bottom row with the country/region and language selectors, payment icons in their own colors, policy links and the Shopify credit. The selectors show when the store sells in more than one country or language.
- In the Add section picker
- Footer. Listed first, without a category.
- Where
- Only in the footer group. In the theme as shipped: Footer.
- Blocks
- Custom Liquid, app blocks, Menu, Brand, Newsletter, Contact and Image card
- Most blocks
- 12
Settings (11)
| Setting | Type and default | What it does |
|---|---|---|
| Color scheme | Color scheme, default Scheme 4 | |
| Wordmark | ||
| Show wordmark | Checkbox, on by default | |
| Wordmark text | Text | Set in the heading font. Leave empty to use the store name. Words of 4 to 12 letters fill it best. Home, collection and product pages show it full width; other pages show one smaller line. Shows when Show wordmark is on. |
| Bottom row | ||
| Show country/region selector | Checkbox, on by default | Shows when the store sells in more than one country. |
| Show language selector | Checkbox, on by default | Shows when the store has more than one language. |
| Show payment icons | Checkbox, on by default | |
| Show Follow on Shop | Checkbox, on by default | Lets customers follow the store in the Shop app. Needs Shop Pay to be turned on. |
| Show policy links | Checkbox, on by default | Write policies in Settings > Policies. |
| Show Shopify credit | Checkbox, on by default | |
| Padding | ||
| Top padding | 0 to 160 px, default 80 px | |
| Bottom padding | 0 to 160 px, default 32 px | |
Menu
A menu column.
- Kind
- Only inside Footer.
Settings (2)
| Setting | Type and default | What it does |
|---|---|---|
| Heading | Text | Leave empty to use the menu name. The Footer menu and Main menu show no heading when this is empty. |
| Menu | Menu |
Brand
Logo or store name, a heading, text and social media links.
- Kind
- Only inside Footer.
Settings (5)
| Setting | Type and default | What it does |
|---|---|---|
| Show logo | Checkbox, off by default | Uses the logo from Theme settings > Logo, or the store name. |
| Label | Text | |
| Heading | Text | |
| Text | Formatted text | A sentence or two about your store. With no logo, label, heading or text, the column shows the store name. |
| Show social media links | Checkbox, on by default | Links come from Theme settings > Social media. |
Newsletter
An email signup form with heading, text and consent text.
- Kind
- Only inside Footer.
Settings (5)
| Setting | Type and default | What it does |
|---|---|---|
| Heading | Text | Set in the small heading style, like the other column headings. |
| Lead | Text | Optional line under the heading, in the heading font. |
| Text | Formatted text | |
| Button label | Text | |
| Consent text | Text | Explain what customers sign up for. You can link to your privacy policy. |
| Subscribers are added to your customer list with email marketing accepted and the tag newsletter. | ||
Contact
Email, phone, address and opening hours, typed in or from the store's contact details.
- Kind
- Only inside Footer.
Settings (6)
| Setting | Type and default | What it does |
|---|---|---|
| Heading | Text | |
| Text | ||
| Phone | Text | |
| Use store contact details | Checkbox, on by default | Shows the store's email and phone number from the store settings when the fields above are empty. |
| Address | Text, several lines | |
| Opening hours | Text, several lines | One line per entry, such as Mon-Fri 9am-5pm. |
Image card
An image with a label, heading, text and link.
- Kind
- Only inside Footer.
Settings (6)
| Setting | Type and default | What it does |
|---|---|---|
| Image | Image | |
| Label | Text | |
| Heading | Text | |
| Text | Text | |
| Link label | Text | |
| Link | Link | The card shows once it has a link. |
Footnotes
The numbered notes of the page, set as endnotes at the end of the main content, plus the compliance statement when a claim's asterisk needs it. The theme places it on every page itself, so it is not in the footer group and can't be moved or removed; it shows only on pages with footnote markers. Its one setting is the heading.
- Where
- Loaded on every page by the theme. It is not in the Add section picker.
Settings (1)
| Setting | Type and default | What it does |
|---|---|---|
| Shows on pages with footnote markers: their notes, then the Compliance statement if the page shows it nowhere else. Footnotes guide | ||
| Heading | Text | |
Header
Logo, menu (mega menus or dropdowns), search, account and cart, and the country/region and language selectors, which are on by default and show when the store sells in more than one country or language. Each selector opens a non-modal list beside its button at every width, kept within the screen. Browsers without popover support use the native footer form. The country selector displays the full country name and currency. Menu image and Menu promo blocks add an image or a promotion to a mega menu. Below 990px the menu opens as a drawer.
- In the Add section picker
- Header. Listed first, without a category.
- Where
- Only in the header group. In the theme as shipped: Header.
- Blocks
- Menu image and Menu promo
- Most blocks
- 8
Settings (15)
| Setting | Type and default | What it does |
|---|---|---|
| Layout | ||
| Logo position on desktop | Options: Left, Center. Default: Center | |
| Logo position on mobile | Options: Left, Center. Default: Left | |
| Upload the logo and the inverse logo, and set the logo widths, in Theme settings > Logo. | ||
| Menu | Menu | |
| Menu style | Options: Mega menu, Dropdown. Default: Mega menu | Mega menus show second-level links as columns, with the menu image and menu promo blocks beside them. |
| Sticky header | Options: Off, On scroll up, Always. Default: On scroll up | |
| Colors | ||
| Color scheme | Color scheme, default Scheme 1 | |
| Transparent on the home page | Checkbox, off by default | The header sits over the first section of the home page and turns solid when the page scrolls. That section's content moves down to clear the header. |
| Transparent header colors | Color scheme, default Scheme 1 | Text and icons use this scheme's text color. Use the first section's color scheme, or one that contrasts with its image. Shows when Transparent on the home page is on. |
| Search | ||
| Popular searches are set in Theme settings > Search. | ||
| Search field text | Text | |
| Collections heading | Text | Shown above the collection list before customers type. Choose the collections in Theme settings > Goals. |
| Account and localization | ||
| Customer account menu | Menu | Links in the account menu. The account icon shows when customer accounts are turned on. |
| Show country/region selector | Checkbox, on by default | On desktop, when the store sells in more than one country. |
| Show language selector | Checkbox, on by default | On desktop, when the store has more than one language. |
| Mobile menu | ||
| Show country/region and language selectors | Checkbox, on by default | |
| Show social media links | Checkbox, on by default | Links come from Theme settings > Social media. |
Menu image
An image with a link, shown in the mega menu of the menu item you choose.
- Kind
- Only inside Header.
Settings (9)
| Setting | Type and default | What it does |
|---|---|---|
| Menu item | Text | Top-level menu item to show this card under, such as Shop. If no item has this name, the card stays hidden and the editor lists it under the header. Leave empty for the first item with links. |
| Collection | Collection | |
| Image | Image | Leave empty to use the collection image. |
| Image ratio | Options: Portrait, 4:5; Square, 1:1; Landscape, 3:2. Default: Portrait, 4:5 | |
| Label | Text | |
| Heading | Text | Leave empty to use the collection title. |
| Text | Text | |
| Link | Link | Leave empty to link to the collection. The card shows once it has a collection or a link. |
| Show in mobile menu | Checkbox, off by default |
Menu promo
A promotion card with a button, shown in the mega menu of the menu item you choose.
- Kind
- Only inside Header.
Settings (9)
| Setting | Type and default | What it does |
|---|---|---|
| Menu item | Text | Top-level menu item to show this card under, such as Shop. If no item has this name, the card stays hidden and the editor lists it under the header. Leave empty for the first item with links. |
| Label | Text | |
| Heading | Text | |
| Detail | Text | Shown after the label, as in ROUTINE QUIZ · 2 MIN. Use it for a time or a price. |
| Text | Text | |
| Button label | Text | |
| Link | Link | The card shows once it has a link. |
| Color scheme | Color scheme, default Scheme 3 | |
| Show in mobile menu | Checkbox, on by default |
Loaded by the theme
Sections the theme loads behind the scenes. They are not in the Add section picker and need no setup.
Batch lookup results
Answers batch code lookups for the batch lookup and the search dialog. It has no settings.
- Where
- Loaded by the theme when it is needed. It is not in the Add section picker.
No settings.
Cart drawer
The cart panel that opens over the page. It is used when Theme settings > Cart > Cart type is Drawer. What it shows follows Theme settings > Cart; its own Heading names the suggested products under the cart lines (Add to your order unless you change it). A suggested product with options, or one sold by subscription only, gets Choose options instead of Add.
- Where
- Loaded on every page by the theme. It is not in the Add section picker.
Settings (2)
| Setting | Type and default | What it does |
|---|---|---|
| Choose the drawer or the cart page in Theme settings > Cart, where lines, note, recommendations and free shipping progress are set too. Goal links in the empty cart come from Theme settings > Goals. | ||
| Recommendations | ||
| Heading | Text | Labels the product suggested under the cart lines. Turn suggestions on or off in Theme settings > Cart. Shows when Theme settings > Cart > Show recommendations is on. |
| Color scheme | Color scheme, default Scheme 1 | |
Localization lists
Loaded by the country/region and language selectors to list the countries and languages the first time a selector opens. It has no settings.
- Where
- Loaded by the theme when it is needed. It is not in the Add section picker.
No settings.
Pickup availability
Loaded by the Pickup availability block to list where the selected variant can be picked up.
- Where
- Loaded by the theme when it is needed. It is not in the Add section picker.
No settings.
Predictive search
Loaded by the search dialog to show suggestions as shoppers type. Its options are in Theme settings > Search, including Popular links and Popular searches, which show before shoppers type and when a search finds nothing. The search field text and the collections heading are in the Header section.
- Where
- Loaded by the theme when it is needed. It is not in the Add section picker.
No settings.
Quick add
Loaded by product cards to show a compact product form in a dialog, with the quantity beside the add to cart button. Theme settings > Product cards > Show quick add turns it on.
- Where
- Loaded by the theme when it is needed. It is not in the Add section picker.
No settings.
Blocks
Theme blocks can go in any section that takes theme blocks: Featured product, Product details, Product information, Section, and the Group block. Grouped by their category in the Add block picker. Blocks that only exist inside one section are listed with that section above.
Product blocks
Blocks that read the product of their section. Use them in Product information, Product details or Featured product. Elsewhere they show nothing, and the theme editor shows a notice.
Collapsible row
A row that opens to show text, a page's content, your shipping or refund policy from Settings > Policies, or for bundles the products in the product's Bundle products metafield. A policy row hides while the policy is empty. A Shipping policy row prints the free shipping threshold from Theme settings > Cart under its heading while free shipping is on (Show free shipping threshold).
- Add it to
- Featured product, Group, Product details, Product information and Section.
- In the theme as shipped
- Default product and Bundle product
Settings (7)
| Setting | Type and default | What it does |
|---|---|---|
| Heading | Text | |
| Icon | Options: None, Truck, Return, Box, Leaf, Flask, Shield, Calendar, Information, Question. Default: None | |
| Content | Options: Text, Page, Shipping policy, Refund policy, Bundle contents. Default: Text | Bundle contents lists the products in the product's Bundle products metafield. Policies come from Settings > Policies; the row is hidden while the policy is empty. |
| Show free shipping threshold | Checkbox, on by default | Prints the threshold from Theme settings > Cart under the heading while free shipping is on there. Shows when Content is “Shipping policy”. |
| Text | Formatted text | Shows when Content is “Text”. |
| Page | Page | Used when Content is Page. |
| Open by default | Checkbox, off by default |
Complementary products
Pairs well with: the complementary products you set in Shopify's Search and Discovery app, as compact rows with an add button. Works on product templates only. The default product template leaves it out, because Related products already shows complementary products first; add it to the buy box for a short list beside the add to cart button.
- Add it to
- Featured product, Group, Product details, Product information and Section.
Settings (6)
| Setting | Type and default | What it does |
|---|---|---|
| Choose complementary products in the Search and Discovery app. On product pages the related products section already shows them first. Hidden when there are none. | ||
| Heading | Options: Small, for the buy box; Large heading. Default: Small, for the buy box | |
| Label in the page navigation bar | Text | Short name in the bar that follows the reader down the product page. Leave it empty to keep this block out of the bar. Shows when Heading is “Large heading”. |
| Heading | Text | |
| Heading layout | Options: Left with line above, Left, Full width. Default: Full width | Left aligns with the content below. Full width suits grids. Shows when Heading is “Large heading”. |
| Maximum products to show | 1 to 6, default 3 | |
| Show add button | Checkbox, on by default | |
Compliance disclaimer
Shopify product disclosures for the buyer's region, then the store statement from Theme settings > Compliance unless a disclosure already gives it, plus optional text, with a label in the margin. Claims that end with an asterisk link to the statement, and while this block shows it the footer leaves out its own copy. With Only on supplement products on, the statement shows on supplement products and wherever a claim carries an asterisk. Place it under the Supplement Facts chapter.
- Add it to
- Featured product, Group, Product details, Product information and Section.
- In the theme as shipped
- Default product and Bundle product
Settings (4)
| Setting | Type and default | What it does |
|---|---|---|
| Shows the product's disclosures for the buyer's region, then your statement from Theme settings > Compliance. Read more | ||
| Only on supplement products | Checkbox, on by default | Shows the store's statement on products with Supplement Facts or a category under Vitamins & Supplements. Claims marked with an asterisk always get it; disclosures always show. |
| Label | Text | Short name in the margin beside the statement. Leave it empty for none. |
| Additional text | Formatted text | For example, a note on use by children or a prescription requirement. |
| Width | Options: Narrow, Full. Default: Narrow | |
Description
The product description, full or short, in body or large text.
- Add it to
- Featured product, Group, Product details, Product information and Section.
- In the theme as shipped
- Default product and Bundle product
Settings (2)
| Setting | Type and default | What it does |
|---|---|---|
| Length | Options: Full, Short. Default: Full | Short shows the first paragraph with a link to read the rest. |
| Text size | Options: Body, Large. Default: Body |
FAQ (product)
The product's questions in an accordion, from the product's FAQ metafield, else Questions and answers, then Question and answer blocks, with optional FAQ structured data.
- Add it to
- Featured product, Group, Product details, Product information and Section.
- In the theme as shipped
- Default product
- Takes
- Question and answer
Settings (9)
| Setting | Type and default | What it does |
|---|---|---|
| Heading | ||
| Label in the page navigation bar | Text | Short name in the bar that follows the reader down the product page. Leave it empty to keep this block out of the bar. |
| Heading | Text | |
| Heading layout | Options: Left with line above, Left, Full width, Hidden. Default: Full width | Left aligns with the content below. Full width suits grids. Hidden keeps it for screen readers. |
| Text | Formatted text | |
| Link label | Text | |
| Link | Link | |
| Questions | ||
| Uses the FAQ metafield or Questions and answers, then question blocks. With one item, it shows as a row in the Specifications table. Setup guide | ||
| Questions and answers | Formatted text | Shows on every product that uses this template. Connect a product metafield for per-product content. Guide |
| Open the first question | Checkbox, off by default | |
| Add FAQ structured data | Checkbox, on by default | Helps search engines read the questions. Turn it off when another FAQ on the same page already provides it. |
Question and answer
One question and answer, after the questions from the FAQ metafield.
- Kind
- Only inside FAQ (product).
Settings (2)
| Setting | Type and default | What it does |
|---|---|---|
| Question | Text | |
| Answer | Formatted text |
Formula details
Above the title: the formula number and goal on one line, then the form, dietary labels and certifications. On phones a short line sits above the title and the other details under the price.
- Add it to
- Featured product, Group, Product details, Product information and Section.
- In the theme as shipped
- Default product and Bundle product
Settings (5)
| Setting | Type and default | What it does |
|---|---|---|
| Show formula number | Checkbox, on by default | Uses the product's Formula number metafield. How to set it up |
| Show goal | Checkbox, on by default | Uses the collection in the product's Goal metafield (with its Accent color), else a collection from Theme settings > Goals that holds the product, else the product's Health focus category metafield. |
| Show product form | Checkbox, on by default | Uses the product's Food supplement form category metafield. |
| Show dietary labels | Checkbox, on by default | Uses the product's Dietary preferences category metafield, else the theme's Dietary metafield. |
| Show certifications | Checkbox, on by default | Uses the product's Product certifications and standards category metafield. GMP is spelled out as GMP-certified facility. |
How to take
Directions from the product's Protocol metafield: amount, when (with a 24-hour dose clock), take with, pairs with, steps and caution, and a safety note. Without a Protocol entry it shows Directions, typed or connected to a product field. It can hold a Results timeline block.
- Add it to
- Featured product, Group, Product details, Product information and Section.
- In the theme as shipped
- Default product
- Takes
- Results timeline
Settings (8)
| Setting | Type and default | What it does |
|---|---|---|
| Uses the Protocol metafield, else Directions below. With one item, it shows as a row in the Specifications table. Setup guide | ||
| Heading | ||
| Label in the page navigation bar | Text | Short name in the bar that follows the reader down the product page, and above the heading. Leave it empty to keep this block out of the bar. |
| Heading | Text | |
| Heading layout | Options: Left with line above, Left, Full width, Hidden. Default: Full width | Left aligns with the content below. Full width suits grids. Hidden keeps it for screen readers. |
| Show section number | Checkbox, on by default | Numbers run in page order. Number the main parts only: four at most read well. Shows when Label in the page navigation bar is set, Heading layout is not “Hidden” and Theme settings > Layout > Section numbering is not “Off”. |
| Text | Formatted text | |
| Without a Protocol entry | ||
| Directions | Formatted text | Shows on every product that uses this template. Connect a product metafield for per-product content. Guide |
| Safety note | ||
| Safety note | Text | Supplement products only. Shows on every supplement product using this template, below How to take or the Specifications table. |
| Show product caution | Checkbox, on by default | Adds the Caution field of the product's Protocol entry to the safety note. |
Ingredients (product)
One row per ingredient that explains its dose and form, with an image, then a Dietary row and a Free from row. Reads the Ingredients metafield, else Ingredient notes, else the ingredient names from the product's category; Ingredient row blocks add more rows.
- Add it to
- Featured product, Group, Product details, Product information and Section.
- In the theme as shipped
- Default product
- Takes
- Ingredient row
Settings (14)
| Setting | Type and default | What it does |
|---|---|---|
| Heading | ||
| Label in the page navigation bar | Text | Short name in the bar that follows the reader down the product page, and above the heading. Leave it empty to keep this block out of the bar. |
| Heading | Text | |
| Heading without doses | Text | Used when no ingredient has a dose or form, for example when the names come from the product's category. |
| Heading layout | Options: Left with line above, Left, Full width, Hidden. Default: Full width | Left aligns with the content below. Full width suits grids. Hidden keeps it for screen readers. |
| Show section number | Checkbox, on by default | Numbers run in page order. Number the main parts only: four at most read well. Shows when Label in the page navigation bar is set, Heading layout is not “Hidden” and Theme settings > Layout > Section numbering is not “Off”. |
| Text | Formatted text | |
| Uses the Ingredients metafield, else Ingredient notes, else the category. With one item, it shows as a row in the Specifications table. Setup guide | ||
| Ingredient notes | Formatted text | Shows on every product that uses this template. Connect a product metafield for per-product content. Guide |
| Free from | ||
| Show free from row | Checkbox, on by default | |
| Row label | Text | Shows when Show free from row is on. |
| Row heading | Text | Shows when Show free from row is on. |
| Free from list | Text, several lines | One item per line, for example Gluten or Artificial colors. Shows when Show free from row is on. |
| Show allergen statement | Checkbox, on by default | The allergen statement of the product's Supplement Facts entry, or "Contains:" with the product's standard Allergen information. Shows when Show free from row is on. |
| Dietary row | ||
| Show dietary row | Checkbox, on by default | A Dietary row with the product's Dietary preferences (set by its category in the admin) and the theme's dietary metafield, for example Vegan or Non-GMO. |
| Dietary row label | Text | Shows when Show dietary row is on. |
Ingredient row
An ingredient row typed into the block, after the rows from the Ingredients metafield.
- Kind
- Only inside Ingredients (product).
Settings (8)
| Setting | Type and default | What it does |
|---|---|---|
| Label | Text | Short reason in the margin, for example Why 200 mg |
| Ingredient | Text | |
| Dose | Text | |
| Form | Text | |
| Origin | Text | |
| Why this form and dose | Formatted text | |
| Image | Image | |
| Image caption | Text | Describe what the image shows. Leave it empty when the image is decorative. |
Key actives
The key actives with dose and a % Daily Value bar, from the Supplement facts rows marked Key active, led by the ingredient the product title names first. It hides when fewer than two rows are marked.
- Add it to
- Featured product, Group, Product details, Product information and Section.
- In the theme as shipped
- Default product
Settings (2)
| Setting | Type and default | What it does |
|---|---|---|
| Shows the Key active rows of the product's Supplement facts entry with their Daily Value bars, when there are two or more. How to set it up | ||
| Heading | Text | Leave empty to show the numbers only. |
| Actives to show | 2 to 3, default 3 | |
Lab results (product)
The product's lab batches, newest first, with the certificate of analysis of the chosen batch and a batch code lookup. Reads the Lab batches metafield. A supplement product without Lab batch entries gives one row in the Specifications table from Certificate link, Batch code and Released on, when they are set.
- Add it to
- Featured product, Group, Product details, Product information and Section.
- In the theme as shipped
- Default product
Settings (14)
| Setting | Type and default | What it does |
|---|---|---|
| Uses the Lab batches metafield, newest first. Without it, the settings below give one row in the Specifications table. Setup guide | ||
| Heading | ||
| Label in the page navigation bar | Text | Short name in the bar that follows the reader down the product page, and above the heading. Leave it empty to keep this block out of the bar. |
| Heading | Text | |
| Heading layout | Options: Left with line above, Left, Full width, Hidden. Default: Full width | Left aligns with the content below. Full width suits grids. Hidden keeps it for screen readers. |
| Show section number | Checkbox, on by default | Numbers run in page order. Number the main parts only: four at most read well. Shows when Label in the page navigation bar is set, Heading layout is not “Hidden” and Theme settings > Layout > Section numbering is not “Off”. |
| Text | Formatted text | |
| Content | ||
| Introduction | Formatted text | |
| Without Lab batch entries | ||
| Certificate link | Link | Shows on every product that uses this template. Connect a product metafield for per-product content. Guide |
| Batch code | Text | Shows on every product that uses this template. Connect a product metafield for per-product content. Guide |
| Released on | Text | Shows on every product that uses this template. Connect a product metafield for per-product content. Guide |
| Batches | ||
| Maximum batches | 1 to 12, default 6 | |
| Show batch code lookup | Checkbox, on by default | |
| Contact link | Link | A link under the batch lookup for shoppers who cannot find their batch, for example your contact page. Leave it empty to hide the link. Shows when Show batch code lookup is on. |
| Color scheme | Color scheme, default Scheme 4 | A scheme that differs from the section's puts this block on a full-width band. |
| Certificate color scheme | Color scheme, default Scheme 2 | |
Price
The price with sale and compare-at prices, the subscription price when a plan is selected, unit price and price per serving (unless the variant picker already shows it), a sold out badge and the tax and shipping note.
- Add it to
- Featured product, Group, Product details, Product information and Section.
- In the theme as shipped
- Default product and Bundle product
Settings (4)
| Setting | Type and default | What it does |
|---|---|---|
| Size | Options: Medium, Large. Default: Large | |
| Show price per serving | Checkbox, on by default | Uses the Servings metafield on the variant, else the product. |
| Show sold out badge | Checkbox, on by default | |
| Show tax and shipping note | Checkbox, on by default | Says when taxes are included and links to the shipping policy when you have one. |
Rating and batch
Star rating and review count from the rating metafields review apps fill in, and the newest lab batch with its status.
- Add it to
- Featured product, Group, Product details, Product information and Section.
- In the theme as shipped
- Default product and Bundle product
Settings (2)
| Setting | Type and default | What it does |
|---|---|---|
| Stars and count come from the rating metafields review apps fill in, the batch from the newest Lab batches entry. How to set up lab batches | ||
| Show rating | Checkbox, on by default | |
| Show current batch | Checkbox, on by default | Links to the lab results further down the page when they are there. |
Results timeline
Steps such as Week 1 or Day 90 on a timeline, from the product's Timeline metafield, then Step blocks, or from Timeline text (one step per line, such as Week 2 | text) when the product has no entries. It can sit on its own or inside How to take.
- Add it to
- Featured product, Group, How to take, Product details, Product information and Section.
- In the theme as shipped
- Default product
- Takes
- Step
Settings (9)
| Setting | Type and default | What it does |
|---|---|---|
| Heading | Options: Large heading, Small heading, Hidden. Default: Large heading | Use the small heading when this block sits inside How to take. |
| Label in the page navigation bar | Text | Short name in the bar that follows the reader down the product page, and above the heading. Leave it empty to keep this block out of the bar. Shows when Heading is “Large heading”. |
| Heading | Text | |
| Heading layout | Options: Left with line above, Left, Full width, Hidden. Default: Full width | Left aligns with the content below. Full width suits grids. Hidden keeps it for screen readers. Shows when Heading is “Large heading”. |
| Show section number | Checkbox, off by default | Numbers run in page order. Number the main parts only: four at most read well. Shows when Label in the page navigation bar is set, Heading layout is not “Hidden”, Theme settings > Layout > Section numbering is not “Off” and Heading is “Large heading”. |
| Text | Formatted text | Shows when Heading is “Large heading”. |
| Footnote | Text | Shown as a numbered note. Keep an honest note here: results differ from person to person. |
| Layout | Options: Horizontal when there is room, Always vertical. Default: Horizontal when there is room | |
| Uses the Timeline metafield or Timeline text, then step blocks. With one item, it shows as a row in the Specifications table. Setup guide | ||
| Timeline text | Formatted text | Shows on every product that uses this template. Connect a product metafield for per-product content. Guide |
Step
One step, after the steps from the Timeline metafield.
- Kind
- Only inside Results timeline.
Settings (3)
| Setting | Type and default | What it does |
|---|---|---|
| Label | Text | |
| Heading | Text | |
| Text | Formatted text |
Reviews
A chapter for your reviews app's block, or a Custom Liquid widget, with an optional rating summary from the rating metafields. It shows only when the app block shows something.
- Add it to
- Featured product, Group, Product details, Product information and Section.
- In the theme as shipped
- Default product and Bundle product
- Takes
- app blocks and Custom Liquid
Settings (6)
| Setting | Type and default | What it does |
|---|---|---|
| Add your reviews app's block inside this block. It shows, with its entry in the page navigation bar, only when the app shows reviews. | ||
| Heading | ||
| Label in the page navigation bar | Text | Short name in the bar that follows the reader down the product page. Leave it empty to keep this block out of the bar. |
| Heading | Text | |
| Heading layout | Options: Left with line above, Left, Full width, Hidden. Default: Full width | Left aligns with the content below. Full width suits grids. Hidden keeps it for screen readers. |
| Text | Formatted text | |
| Display | ||
| Show rating summary | Checkbox, on by default | The average rating and review count from the product's rating metafields, which most reviews apps fill in. |
| Set reviews in the theme's type | Checkbox, on by default | Gives review titles, texts and names inside the app's block the theme's fonts. Turn it off if your app's own styles look better. |
SKU
The selected variant's SKU.
- Add it to
- Featured product, Group, Product details, Product information and Section.
No settings.
Supplement Facts
The Supplement Facts label as a table, the % Daily Value plot, the label version line and the label PDF link. Reads the product's Supplement facts metafield, or the selected variant's own label when it has one. On supplement products without an entry it prints Label rows, typed or connected to a product field, with Serving size and Servings per container, else Label image. Other products ignore these settings.
- Add it to
- Featured product, Group, Product details, Product information and Section.
- In the theme as shipped
- Default product
Settings (11)
| Setting | Type and default | What it does |
|---|---|---|
| Uses the Supplement Facts metafield (a variant's own entry first), else Label rows, else Label image. Setup guide | ||
| Heading | ||
| Label in the page navigation bar | Text | Short name in the bar that follows the reader down the product page, and above the heading. Leave it empty to keep this block out of the bar. |
| Heading | Text | |
| Heading layout | Options: Left with line above, Left, Full width, Hidden. Default: Full width | Left aligns with the content below. Full width suits grids. Hidden keeps it for screen readers. |
| Show section number | Checkbox, on by default | Numbers run in page order. Number the main parts only: four at most read well. Shows when Label in the page navigation bar is set, Heading layout is not “Hidden” and Theme settings > Layout > Section numbering is not “Off”. |
| Text | Formatted text | |
| Without a Supplement Facts entry | ||
| Label rows | Formatted text | Shows on every product that uses this template. Connect a product metafield for per-product content. Guide |
| Serving size | Text | Shows on every product that uses this template. Connect a product metafield for per-product content. Guide |
| Servings per container | Text | Shows on every product that uses this template. Connect a product metafield for per-product content. Guide |
| Label image | Image | Shows on every product that uses this template. Connect a product metafield for per-product content. Guide |
| Display | ||
| Show Daily Value plot | Checkbox, on by default | Plots the key ingredients against the Daily Value beside the label. Turn on Key active for those rows in the Supplement Facts entry; without them every row with a Daily Value shows. |
| Show label version line | Checkbox, on by default | Label version, Label updated and Label PDF from the Supplement Facts entry, under the plot. |
Title
The product name, with the Product subtitle under it.
- Add it to
- Featured product, Group, Product details, Product information and Section.
- In the theme as shipped
- Default product and Bundle product
Settings (2)
| Setting | Type and default | What it does |
|---|---|---|
| Size | Options: Large, Medium, Small. Default: Large | |
| Show subtitle | Checkbox, on by default | Uses the product's Product subtitle metafield, Shopify's standard definition. How to set it up |
Vendor
The product's vendor.
- Add it to
- Featured product, Group, Product details, Product information and Section.
Settings (0)
| Setting | Type and default | What it does |
|---|---|---|
| Shows the product's vendor, linked to a list of that vendor's products. | ||
Purchase blocks
Blocks for the buy box: options, buttons, stock, delivery and assurance.
Buy buttons
Quantity selector, add to cart button and dynamic checkout buttons, plus the recipient form for gift cards.
- Add it to
- Featured product, Group, Product details, Product information and Section.
- In the theme as shipped
- Default product and Bundle product
Settings (4)
| Setting | Type and default | What it does |
|---|---|---|
| Show quantity selector | Checkbox, on by default | Quantity rules and volume pricing from Shopify show beside it. |
| Show price on the button | Checkbox, on by default | |
| Show dynamic checkout buttons | Checkbox, on by default | Shows the payment methods available in your store, such as Shop Pay. |
| Show gift card recipient form | Checkbox, on by default | Gift card products only. Shoppers can send the card to someone by email on a chosen date. |
Guarantee
A guarantee with an icon, heading, text and link.
- Add it to
- Featured product, Group, Product details, Product information and Section.
Settings (6)
| Setting | Type and default | What it does |
|---|---|---|
| Heading | Text | |
| Text | Formatted text | |
| Link label | Text | |
| Link | Link | Shows when Link label is set. |
| Icon | Options: None, Shield, Return, Heart, Certificate. Default: Shield | |
| Style | Options: Plain, Outlined, Filled. Default: Outlined |
Installments
Shop Pay Installments message for the selected variant. Shopify shows it only when installments are on for your store and the price is in range.
- Add it to
- Featured product, Group, Product details, Product information and Section.
- In the theme as shipped
- Default product and Bundle product
Settings (0)
| Setting | Type and default | What it does |
|---|---|---|
| Shows the Shop Pay Installments banner when it's turned on in your payment settings and the price qualifies. | ||
Inventory status
Stock message for the selected variant, from Shopify's inventory: in stock, low stock, or for a sold out variant its restock note, the next restock date and a nearby option that is in stock. Variants whose inventory isn't tracked show nothing. For back-in-stock alerts, add your back-in-stock app's block under Buy buttons.
- Add it to
- Featured product, Group, Product details, Product information and Section.
- In the theme as shipped
- Default product and Bundle product
Settings (5)
| Setting | Type and default | What it does |
|---|---|---|
| Uses Shopify inventory; untracked variants show nothing. For back-in-stock alerts, add an app block under Buy buttons. Learn more | ||
| Low stock threshold | 1 to 50, default 10 | Shows low stock at or under this quantity. |
| Show how many are left when stock is low | Checkbox, on by default | |
| Show in stock | Checkbox, on by default | |
| Show restock date for sold out variants | Checkbox, on by default | Uses the Restock note metafield on the variant or product, else the next incoming date from Shopify. |
| Suggest an option in stock | Checkbox, on by default | When the selected option is sold out, links to the nearest option in stock, such as another size. |
Pickup availability
Whether the selected variant can be picked up, with a drawer that lists the locations. Needs local pickup set up in Shopify.
- Add it to
- Featured product, Group, Product details, Product information and Section.
- In the theme as shipped
- Default product and Bundle product
Settings (0)
| Setting | Type and default | What it does |
|---|---|---|
| Shows where the selected variant can be picked up, for locations with local pickup turned on. | ||
Purchase options
One-time purchase and the subscription plans from your subscription app, with the cadence choice, tag and perks. One-time purchase comes first and is selected when the page loads, unless the product is sold by subscription only. The tag and perks are set in Theme settings > Subscriptions. It shows only for products with selling plans.
- Add it to
- Featured product, Group, Product details, Product information and Section.
- In the theme as shipped
- Default product and Bundle product
Settings (0)
| Setting | Type and default | What it does |
|---|---|---|
| One-time purchase and your subscription app's plans. One-time comes first unless the product is subscription only. Learn more | ||
Share
A share button: the device's share sheet where the browser has one, otherwise it copies the product link.
- Add it to
- Featured product, Group, Product details, Product information and Section.
- In the theme as shipped
- Default product and Bundle product
Settings (1)
| Setting | Type and default | What it does |
|---|---|---|
| Show label | Checkbox, on by default |
Shipping note
A shipping line with an icon, the free shipping threshold when free shipping is on, and links to the shipping and refund policies. The default product templates leave it out, because their Shipping row already gives the threshold.
- Add it to
- Featured product, Group, Product details, Product information and Section.
Settings (5)
| Setting | Type and default | What it does |
|---|---|---|
| Show free shipping threshold | Checkbox, on by default | Uses the free shipping settings in Theme settings > Cart. Shows only when free shipping is turned on there and the shopper pays in your store currency. |
| Text | Text | For example, when orders ship. |
| Icon | Options: None, Truck, Box, Globe, Clock. Default: None | |
| Link to the shipping policy | Checkbox, off by default | |
| Link to the refund policy | Checkbox, on by default |
Trust badges
Short assurance rows, one Trust item block each, such as lab testing, shipping and returns, from your own text or from live store details. In the Rows layout each row is an icon and one line led by its label, such as "Tested: Batch MG-24118..."; Compact shows icons and labels only.
- Add it to
- Featured product, Group, Product details, Product information and Section.
- In the theme as shipped
- Default product and Bundle product
- Takes
- Trust item
Settings (1)
| Setting | Type and default | What it does |
|---|---|---|
| Layout | Options: Rows, Compact. Default: Rows | Compact shows each item's icon and label only. |
Trust item
One assurance row: label, text and icon, or live details (the newest lab batch, the free shipping threshold or the return policy).
- Kind
- Only inside Trust badges.
Settings (4)
| Setting | Type and default | What it does |
|---|---|---|
| Label | Text | |
| Details | Options: Text only, Newest lab batch, Free shipping threshold, Refund policy link. Default: Free shipping threshold | Live details hide the row when the store hasn't set them up: the product's Lab batches metafield, free shipping in Theme settings > Cart, or a refund policy in Settings > Policies. |
| Text | Text | Shown after the live details. Return windows and other terms appear only when you type them here. |
| Icon | Options: None, Check mark, Flask, Certificate, Truck, Return, Leaf, Shield, Lock, Chat. Default: Check mark | Shown in the compact layout. |
Variant picker
Product options as swatches, option cards, chips or a dropdown, chosen per option: swatches when every value has a swatch; a dropdown with the Dropdown style or more than 12 values; option cards, with prices, for the option that changes the price when it has 6 values or fewer; chips for the rest and for short values such as S, M and L. Shows price per serving and serving size where they differ between options.
- Add it to
- Featured product, Group, Product details, Product information and Section.
- In the theme as shipped
- Default product and Bundle product
Settings (5)
| Setting | Type and default | What it does |
|---|---|---|
| Style | Options: Cards, Dropdown. Default: Cards | |
| Show swatches | Checkbox, on by default | An option shows as swatches when every value has a color or image set in Shopify admin; otherwise as cards with the value names. |
| Show price on cards | Checkbox, on by default | Prices show only when the values of an option differ in price. Shows when Style is “Cards”. |
| Show price per serving | Checkbox, on by default | Uses the Servings metafield on each variant. Shows only when the price per serving differs between values. Shows when Style is “Cards” and Show price on cards is on. |
| Show serving size | Checkbox, on by default | From the selected variant's Supplement facts entry, else the product's, beside the first option's name. How to set it up |
Text blocks
Headings, text and figures for any section that takes theme blocks.
Heading
A heading with size, heading level and alignment.
- Add it to
- Featured product, Group, Image banner, Image with text, Product details, Product information, Rich text and Section.
- In the theme as shipped
- Home page and About page
Settings (4)
| Setting | Type and default | What it does |
|---|---|---|
| Heading | Text | Set a word in italics to show it in the display italic. |
| Size | Options: Display, Extra large, Large, Medium, Small, Extra small, Smallest. Default: Large | |
| Heading level | Options: Heading 1, Heading 2, Heading 3, Heading 4, Paragraph. Default: Heading 2 | For screen readers and search engines. Use one first-level heading per page, then nest the rest. |
| Alignment | Options: Left, Center, Right. Default: Left |
Icon with text
An icon beside a short line of text, with an optional footnote.
- Add it to
- Featured product, Group, Image banner, Image with text, Product details, Product information, Rich text and Section.
Settings (4)
| Setting | Type and default | What it does |
|---|---|---|
| Icon | Options: None, Check mark, Flask, Certificate, Shield, Leaf, Capsule, Scoop, Drop, Truck, Box, Arrows in a circle, Calendar, Clock, Sun, Moon, Globe, Lock, Heart, Gift, Speech bubble, Envelope, Information. Default: Check mark | |
| Text | Text | |
| Text style | Options: Small; Small, secondary color; Body. Default: Small | |
| Footnote | Text | Adds a numbered note at the bottom of the page. Use it for sources, sample sizes and claims. |
Key figure
A large number with a unit, label, text and footnote, which can count up as it scrolls into view.
- Add it to
- Featured product, Group, Image with text, Key figures, Product details, Product information, Rich text and Section.
- In the theme as shipped
- About page
Settings (9)
| Setting | Type and default | What it does |
|---|---|---|
| Label | Text | |
| Number | Text | Plain numbers like 98 or 4.8 count up when they appear on screen. Leave empty to hide the figure on the store. |
| Unit | Text | For example %, mg or days. |
| Text | Formatted text | Say what the figure counts, and use one customers can check. About 60 characters reads best on phones. |
| Footnote | Text | Adds a numbered note at the bottom of the page. Use it for sources, sample sizes and claims. |
| Size | Options: Small, Medium, Large. Default: Medium | |
| Alignment | Options: Left, Center. Default: Left | |
| Use the accent color | Checkbox, off by default | Marks the figure with a small square in the accent color. Use it on one figure at most. |
| Count up | Checkbox, on by default | Only for visitors who allow motion. The final number is always in the page. |
List item
A label, text and value on one line, with a marker and footnote, for specification lists.
- Add it to
- Featured product, Group, Image with text, Product details, Product information, Rich text and Section.
Settings (5)
| Setting | Type and default | What it does |
|---|---|---|
| Label | Text | |
| Text | Text | |
| Value | Text | A dose, a count or a time, shown at the end of the row. |
| Marker | Options: None, Number, Check mark. Default: None | |
| Footnote | Text | Adds a numbered note at the bottom of the page. Use it for sources, sample sizes and claims. |
Text
Rich text with style, alignment, secondary color and line length options, and an optional footnote.
- Add it to
- Featured product, Group, Image banner, Image with text, Product details, Product information, Rich text and Section.
- In the theme as shipped
- Home page and About page
Settings (6)
| Setting | Type and default | What it does |
|---|---|---|
| Text | Formatted text | |
| Text style | Options: Body, Large, Small, Label. Default: Body | |
| Alignment | Options: Left, Center, Right. Default: Left | |
| Use secondary text color | Checkbox, off by default | |
| Limit line length | Checkbox, on by default | Keeps lines short enough to read comfortably. |
| Footnote | Text | Adds a numbered note at the bottom of the page. Use it for sources, sample sizes and claims. |
Media blocks
Images.
Image
An image with ratio, width, alignment, link and caption.
- Add it to
- Featured product, Group, Image with text, Product details, Product information, Rich text and Section.
Settings (7)
| Setting | Type and default | What it does |
|---|---|---|
| Image | Image | |
| Image ratio | Options: Natural; Square, 1:1; Portrait, 4:5; Tall, 3:4; Landscape, 3:2; Wide, 16:9. Default: Natural | |
| Width | 25 to 100 %, default 100 % | |
| Alignment | Options: Left, Center, Right. Default: Left | |
| Link | Link | |
| Show figure caption | Checkbox, off by default | |
| Image caption | Text | Describe what the image shows. Leave empty to use the image's alt text. Shows when Show figure caption is on. |
Links blocks
Buttons.
Button
A link styled as a button, in primary, secondary or text link style.
- Add it to
- Featured product, Group, Image banner, Image with text, Product details, Product information, Rich text and Section.
- In the theme as shipped
- Home page and About page
Settings (6)
| Setting | Type and default | What it does |
|---|---|---|
| Button label | Text | |
| Button link | Link | The button shows once it has a link. |
| Open link in a new window | Checkbox, off by default | |
| Button style | Options: Primary, Secondary, Text link. Default: Primary | |
| Large | Checkbox, off by default | |
| Full width on mobile | Checkbox, off by default |
Layout blocks
Containers and spacing.
Divider
A horizontal line with space above and below.
- Add it to
- Featured product, Group, Image with text, Product details, Product information, Rich text and Section.
Settings (2)
| Setting | Type and default | What it does |
|---|---|---|
| Style | Options: Hairline, Strong. Default: Hairline | |
| Space above and below | 0 to 64 px, default 8 px |
Group
A container that arranges other blocks in a row or a column, optionally as a card with its own color scheme. Presets: Group, Row and Card.
- Add it to
- Featured product, Group, Image with text, Product details, Product information, Rich text and Section.
- Presets
- Group, Row, Card
- Takes
- any theme block and app blocks
Settings (11)
| Setting | Type and default | What it does |
|---|---|---|
| Name | Text | Tells groups apart in the sidebar. Screen readers also announce it. It is not shown on the page. |
| Arrange blocks | Options: Stacked, Side by side. Default: Stacked | |
| Stack on mobile | Checkbox, on by default | Shows when Arrange blocks is “Side by side”. |
| Horizontal alignment | Options: Left, Center, Right, Spread out. Default: Left | |
| Vertical alignment | Options: Top, Middle, Bottom, Spread out. Default: Top | |
| Space between blocks | 0 to 64 px, default 16 px | |
| Width | Options: Fill the space, Fit the content. Default: Fill the space | Applies when the group sits beside other blocks. |
| Appearance | ||
| Style | Options: Plain, Sheet with a border, Tinted panel, Divider above. Default: Plain | |
| Inner padding | 0 to 64 px, default 0 px | |
| Use its own color scheme | Checkbox, off by default | |
| Color scheme | Color scheme, default Scheme 3 | Shows when Use its own color scheme is on. |
Spacer
Empty space, with separate heights for desktop and mobile.
- Add it to
- Featured product, Group, Image banner, Image with text, Product details, Product information, Rich text and Section.
Settings (2)
| Setting | Type and default | What it does |
|---|---|---|
| Height on desktop | 0 to 160 px, default 32 px | |
| Height on mobile | 0 to 160 px, default 16 px |
Advanced blocks
Your own code.
Custom Liquid
Your own Liquid or HTML inside a section.
Settings (1)
| Setting | Type and default | What it does |
|---|---|---|
| Liquid code | Liquid code | Add app snippets or other code to make advanced customizations. |
App blocks
Sections that list app blocks accept blocks from apps you install, such as a reviews widget or a back-in-stock form. They appear under Apps in the Add block picker. App embeds, which apps add to every page, are under App embeds in the editor sidebar.