Sections and blocks
Every page of the store is built from sections, and most sections are built from blocks. This page lists each section you can add, says what it is for and gives its settings. Sections are named here exactly as they are in the theme editor.
Add and arrange sections#
- In the theme editor, open the page you want to change from the template picker at the top.
- In the sidebar, select Add section and choose a section. Sections with a ready-made variation, such as Team, are listed under the same search.
- Drag sections and blocks by their handle to reorder them. Select one to see its settings.
The home page has no fixed layout: it is the list of sections in the index template. The same sections can be added to any page, product or collection template unless noted.
Settings every section shares#
Most sections have the same settings for their heading and their place in the page. They are listed once here and left out of the tables below.
| Setting | What it does |
|---|---|
| Size | Small, Medium or Large. Each size changes the layout, not only the scale. The note under the setting says what changes for that section. |
| Label | A short line above the heading, set in the label font. |
| Heading size | Small, Medium or Large. |
| Heading level | Heading 1, Heading 2 or Heading 3. Use Heading 1 when the section opens the page, so the page has one main heading. |
| Heading alignment | Left or Center. |
| Heading position | Above the content, or pinned on the left or on the right. Pinned: on desktop the heading stays in view on one side while the content scrolls in the reading column on the other. On mobile the heading comes first. |
| Arrival | How the section arrives the first time it comes on screen. In its own way uses the movement designed for that section, Fade is a plain fade and None shows it at once. Follows Theme settings > Motion and the visitor's reduced motion preference. |
| Space above, Space below | By size follows the section size. Double, Half and None change it. A few sections use Top spacing and Bottom spacing in pixels instead. |
| Anchor | A short name without spaces. A link that ends with # and this name scrolls to the section. For example, with the anchor sizes, link to /pages/guide#sizes. |
| Color scheme | One of the schemes from Theme settings > Colors. |
Videos behave the same way wherever a section accepts one. An uploaded video can play as a Silent loop, which starts by itself while on screen and always has a pause button, or as a Player with sound, which waits for the play button. A YouTube or Vimeo link always opens a player and loads only when a visitor presses play.
Heroes and openers#
Hero#
The main hero of the theme: one image, or a silent video loop, that opens the page. Text, buttons and capsules are blocks, each placed With the text or At the foot of the image. A Hotspot is a small glass point placed on something in the image. It opens a capsule with a name and a price that links to a product. Set the focal point of the image in the image picker so the important part stays in view on every screen.
Blocks:
- Label: Label, Style, Place.
- Heading: Heading, Size, Heading level, Place.
- Text: Text, Size, Place.
- Buttons: First button label, First button link, First button style, Second button label, Second button link, Second button style, Size, Show arrow, Stack on mobile, Place.
- Glass capsule: Label, Second line, Link, Show arrow, Place.
- Statements: Statements, Style, Place.
- Product capsule: Product, Show image, Show price, Button action, Add to cart label, Product page label, Place.
- Spacer: Height.
- Custom Liquid: Liquid code, Place.
- Hotspot: Product, Label, Second line, Link, Horizontal position, Vertical position, Capsule opens, Use another position on mobile, Horizontal position on mobile, Vertical position on mobile, Hide on mobile.
- Also accepts app blocks.
Settings of Hero
| Setting | What it does |
|---|---|
| An image that opens the page. Add text, buttons, a glass capsule and hotspots as blocks. A hotspot is a small glass point placed on something in the image: it opens a capsule that links to a product. | |
| Size | Small is a banner with single lines. Medium fills most of the screen. Large takes the whole first screen. |
| Height | |
| Height | |
| Height on mobile | |
| Start under the header | The header floats over the image and its text takes the text color chosen below. |
| Frame the image | Adds a margin and round corners. |
| Space below | |
| Image | |
| Image | 3200 x 1800px .jpg recommended. The focal point of the image is kept in view on every screen. |
| Image on mobile | Optional. A portrait crop shown on portrait screens. 1200 x 2000px .jpg recommended. |
| Silent loop | Optional. Plays over the image without sound, in a loop, with a pause button. It loads after the page and never for visitors who asked for reduced motion. |
| Silent loop on mobile | |
| Text color over the image | |
| Content | |
| Position | The framed image keeps its text at the top. |
| Position on mobile | |
| Text alignment | |
| Text alignment on mobile | |
| Content width | |
| Position of blocks at the foot | |
| Arrival | Follows the motion setting of the theme and the visitor's reduced motion preference. |
| Overlay | |
| Overlay strength | |
| Overlay shape | |
| Overlay color | |
| Colors | |
| Bottom edge color | The image stops 1px above the bottom edge. Pick the color of its last row to hide the line. |
Split hero#
An image on one side and a heading, text and up to two buttons on the other. It can also show a silent video loop or a 3D model of a product. Use it as a first screen when you want the text to carry as much weight as the picture.
Settings of Split hero
| Setting | What it does |
|---|---|
| Size | Small is a short band with the heading and one button. Medium is a first screen. Large gives the image more of the width and the heading its largest size. |
| Image | |
| Image | 2000 x 2400px .jpg recommended. Set the focal point on the image. |
| Image on mobile | 1200 x 1200px .jpg recommended. |
| Video loop | Plays without sound over the image, with a pause button. It loads only when it comes on screen. |
| 3D model from a product | Shows the first 3D model of this product behind a button on the image. It loads when a visitor asks for it, and offers "View in your space" where the device allows. |
| Image position | |
| Image width | |
| Image height | |
| Image height on mobile | |
| Image shape | |
| Show image in a card | |
| Order on mobile | |
| Label on the image | |
| Line on the image | A short fact in a glass label. |
| Label position | |
| Text | |
| Label | |
| Heading | |
| Text | |
| Statements | One short statement per line. Shown as pills. |
| Rows | One per line, as Label: value. They are drawn as rows with a dotted leader. |
| Vertical position | |
| Alignment | |
| Buttons | |
| First button label | |
| First button link | |
| First button style | |
| Second button label | |
| Second button link | |
| Second button style | |
| Note | Small print under the buttons. |
Image banner#
A wide image or video with a heading, a short text and up to two buttons, on a glass plate or directly on the image. Use Overlay strength when light text sits on a bright image.
Settings of Image banner
| Setting | What it does |
|---|---|
| Size | Small is a short band without the text under the heading. Medium is the standard height. Large takes almost the whole screen. |
| Image | 2800 x 1600px .jpg recommended |
| Image for mobile | 1600 x 2000px .jpg recommended |
| Video | Shown over the image, which stays its poster. |
| Video plays as | A loop plays by itself while on screen and has a pause button. A player waits for the play button and then shows its controls. |
| YouTube or Vimeo link | Loads only when a visitor presses play. An uploaded video is used first. |
| Layout | |
| Width | |
| Adapt height to the image | When off, the size sets the height. |
| Height on mobile | |
| Overlay strength | Darkens the image under light text placed on it. |
| Text | |
| Label | |
| Heading | |
| Text | |
| Button label | |
| Second line | A short note under the label, such as a price. Shown on the glass capsule. |
| Button link | |
| Second button label | |
| Second button link | |
| Text style | The glass plate keeps text readable over any image. |
| Text color | |
| Horizontal position | |
| Vertical position | |
| Text alignment | |
Slideshow#
Several slides that move like the product gallery: by swipe, by arrow keys or from the previews on the glass rail. Each slide has its own image or video and text. When Change slides automatically is on, a pause button is always shown.
Blocks:
- Slide: Image, Video, Video plays as, YouTube or Vimeo link, Label, Heading, Text, Button label, Second line, Button link, Text style, Text color, Horizontal position, Vertical position.
- Also accepts app blocks.
Settings of Slideshow
| Setting | What it does |
|---|---|
| Slides move like the product gallery: swipe, use the arrow keys, or pick a preview on the glass rail. | |
| Size | Small is a short stage without arrows, slide count or slide text. Medium is the standard height. Large takes almost the whole screen. |
| Label | A short line above the heading, set in the label font. |
| Heading | |
| Text | |
| Heading alignment | |
| Layout | |
| Width | |
| Rail | |
| Show arrows and slide count | |
| Autoplay | |
| Change slides automatically | A pause button is always shown. Autoplay stops when a visitor uses the slideshow and never starts for visitors who ask for reduced motion. |
| Change slides every | |
Page header#
A compact opening for an inner page: a label, the title, one paragraph and links to parts of the page. Leave Heading empty to use the page title.
Settings of Page header
| Setting | What it does |
|---|---|
| A compact opening for a page: a label, the title, one paragraph and links to the parts of the page. Leave the heading empty to use the page title. | |
| Size | Small is the title on one line. Medium adds the text and links. Large sets the title at display size. |
| Label | |
| Heading | Leave empty to use the page title. |
| Text | |
| Links to parts of the page | One per line, as Label | #anchor or Label | /pages/handle. |
| Alignment | |
| Text width | |
| Image | |
| Image | 2400 x 1200px .jpg recommended. Shown beside the text on desktop and under it on mobile. |
| Image ratio | |
| Show line under the header | |
Video#
A poster and one play button. The player loads only when a visitor presses play, which keeps the page light.
Settings of Video
| Setting | What it does |
|---|---|
| Shows a poster and one glass button. The player loads only when a visitor presses play. | |
| Size | Small keeps the video in a narrow column. Medium is the page width. Large runs from edge to edge, without a frame. |
| Video | An uploaded video is used first. |
| Video plays as | A loop plays by itself while on screen and has a pause button. A player waits for a press and plays with sound. Links always open a player. |
| YouTube or Vimeo link | |
| Poster | 2600 x 1462px .jpg recommended. Uploaded videos use their own first frame when this is empty. |
| Video title | Read by screen readers and shown on the button when the button label is empty. |
| Button label | |
| Caption | |
| Layout | |
| Shape | |
| Show video in a card | |
| Label | A short line above the heading, set in the label font. |
| Heading | |
| Text | |
| Heading alignment | |
Notice#
One line of news inside the page: a new product, a delivery note, a date. It can count down to a real date and can be closed by the visitor. For news above the header on every page, use the announcement bar.
Settings of Notice
| Setting | What it does |
|---|---|
| One line of news inside the page: a new product, a delivery note, an opening, a date. It can run the full width at any size, count down to a real date, carry a button and be closed by the visitor. | |
| Size | Small is a single pill. Medium is a band. Large sets the line at heading size. |
| Full width | The notice runs from edge to edge of the screen, at any size. |
| Tone | |
| Alignment | |
| Content | |
| Icon | Shown before the text. |
| Mark | A short word in a pill before the text, for example New. |
| Text | |
| Link label | |
| Link | |
| Link style | |
| Countdown | |
| End date and time | Optional. Write 2026-11-28T09:00:00+01:00. Without an offset the store time zone is used. The countdown runs to this one moment for every visitor and never restarts. |
| Show seconds | |
| When the time is over | |
| Text when the time is over | |
| Closing | |
| Let visitors close it | Stays closed for the visit. It comes back when the text changes. |
Marquee#
One slow line of short statements. It stops under the pointer, has a pause control and stays still for visitors who ask for reduced motion. Turn on Show as a still line for a line that never moves.
Blocks:
- Statement: Text, Icon, Link.
Settings of Marquee
| Setting | What it does |
|---|---|
| One slow line of short statements. It stops under the pointer, can be paused, and stays still for visitors who ask for reduced motion. | |
| Size | Small sets the statements in the label font. Medium sets them at heading size. Large sets them at display size. |
| Time for one pass | Slower is easier to read. |
| Space between statements | |
| Direction | |
| Between statements | |
| Style | |
| Show as a still line | One centered line that wraps and does not move. |
Products and collections#
Featured collection#
Products from one collection, as a grid, a row that scrolls or one large card with smaller ones. Card options such as the second image, swatches and quick add come from Theme settings > Product cards.
Settings of Featured collection
| Setting | What it does |
|---|---|
| Label | A short line above the heading, set in the label font. |
| Heading | |
| Collection | |
| Show collection description | |
| Layout | |
| Size | Small is a dense catalog, large an editorial grid with fewer columns and taller images. |
| Maximum products to show | |
| Columns on desktop | |
| Columns on mobile | |
| Show a link to the collection | |
| Link label | |
| Product cards | |
| Card style | |
| Image fit | |
| Product video on cards | Plays the first video of a product as a silent loop. On mobile one video plays at a time. |
Featured product#
One product with its gallery and buy buttons, outside the product page. It uses the same blocks as the product page: Product heading, Price, Variant picker, Buy buttons, Purchase options and others. See Product page.
Blocks:
- Also accepts any theme block and app blocks.
Settings of Featured product
| Setting | What it does |
|---|---|
| Size | Small is a compact product with a narrow stage and no previews. Medium splits the row in two. Large gives the gallery more width and more air. |
| Product | |
| Gallery position | |
| Gallery ratio | |
| Media fit | |
| Show previews | |
| Enable image zoom | |
| Enable video looping |
Collection list#
Collections you choose, as a grid, a scrolling row, one large tile with smaller ones, or ledger rows with the product count.
Settings of Collection list
| Setting | What it does |
|---|---|
| Label | A short line above the heading, set in the label font. |
| Heading | |
| Text | |
| Collections | |
| Layout | |
| Size | Small is a dense catalog, large an editorial grid with fewer columns and taller images. |
| Card style | The editorial layout always uses images. |
| Image ratio | |
| Columns on desktop | |
| Columns on mobile | |
| Show product count | |
| Show a link to all collections | |
| Link label |
Bundle builder#
Lets customers build their own set from a pool of products and add it to the cart in one press. See Bundles for how the builder works and what it does not do.
Settings of Bundle builder
| Setting | What it does |
|---|---|
| Size | Small shows the products as rows. Medium is a grid with the summary pinned beside it. Large gives the pictures more room. |
Related products#
Shopify's related products for the product being viewed. Available on product templates only. For recommendations inside the product column, use the Related products block of the product page instead.
Settings of Related products
| Setting | What it does |
|---|---|
| Size | Small shows compact rows in one card. Medium shows a row of cards. Large shows fewer, larger cards under a larger heading. |
| Heading | |
| Maximum products to show | |
| Columns on desktop |
Blog posts#
The latest posts of one blog, as a grid, with the first post large, or as rows.
Settings of Blog posts
| Setting | What it does |
|---|---|
| Size | Small is a list of post titles without images or excerpts. Medium is the chosen layout. Large shows 2 posts a row with more space between them. |
| Blog | |
| Label | A short line above the heading, set in the label font. |
| Heading | |
| Text | |
| Heading alignment | |
| Heading position | Pinned: on desktop the heading stays in view on one side while the content scrolls in the reading column on the other, as the gallery and column of the product page do. On mobile the heading comes first. |
| Layout | |
| Layout | |
| Columns on desktop | |
| Columns on mobile | |
| Posts to show | |
| Show featured image | |
| Show images in a card | |
| Show date | |
| Show author | |
| Show excerpt | |
| Link label | |
Evidence and trust#
Claims#
A list of statements, each with the figure behind it and a numbered source. Sources are listed under the claims. Use it when a claim needs a reference, for example a study.
Blocks:
- Claim: Icon, Figure, Unit, Claim, Text, Source, Source link.
- Also accepts app blocks.
Settings of Claims
| Setting | What it does |
|---|---|
| A list of statements, each with the figure behind it and a numbered source. The sources are listed under the claims. | |
| Size | Small is one line per claim. Medium adds the explanation. Large sets each figure at display size. |
| Heading | |
| Label | |
| Heading | |
| Text | |
| Heading alignment | |
| Heading position | Pinned: on desktop the heading stays in view on one side while the content scrolls in the reading column on the other, as the gallery and column of the product page do. On mobile the heading comes first. |
| Layout | |
| Layout | |
| Columns on desktop | |
| Columns on mobile | |
| Icon style | |
| Show source list | |
| Fold the source list | The sources stay closed under one quiet line at the foot of the section and the claims carry no reference marks. Turn off to number each claim and show the list open. |
| Source list heading | |
| Note | Small print under the list, such as a regulatory statement. |
| Section | |
| Count up to each figure | Each number runs up to its value once, when it comes on screen. Follows the motion setting of the theme. |
Figures#
A row of numbers, each with one line that says what it measures. With Count up to each figure on, each number runs up to its value once when it comes on screen.
Blocks:
- Figure: Icon, Label, Figure, Unit, Text, Source, Source link.
- Also accepts app blocks.
Settings of Figures
| Setting | What it does |
|---|---|
| A row of numbers, each with one line that says what it measures and where it comes from. | |
| Size | Small sets the figures at a compact size. Medium is the standard row. Large gives each figure its own row at display size. |
| Label | A short line above the heading, set in the label font. |
| Heading | |
| Text | |
| Heading alignment | |
| Heading position | Pinned: on desktop the heading stays in view on one side while the content scrolls in the reading column on the other, as the gallery and column of the product page do. On mobile the heading comes first. |
| Layout | |
| Columns on desktop | |
| Columns on mobile | |
| Style | |
| Icon style | |
| Alignment | |
| Note | Small print under the row, such as how the numbers were counted. |
| Section | |
| Count up to each figure | Each number runs up to its value once, when it comes on screen. Follows the motion setting of the theme. |
Facts table#
A table of what a product is made of: ingredients, materials or specifications, each with an amount and an optional note. It can sit beside an image.
Blocks:
- Row: Name, Note, Amount, Second value.
- Group heading: Heading.
Settings of Facts table
| Setting | What it does |
|---|---|
| A table of what the product is made of: ingredients, materials or specifications, each with an amount and an optional note. | |
| Size | Small is the table alone. Medium sets it beside an image. Large gives the image the height of the screen and adds room to each row. |
| Heading | |
| Label | |
| Heading | |
| Text | |
| Heading alignment | |
| Table | |
| Table heading | |
| Line under the table heading | For example, the quantity or the product measured. |
| First column heading | |
| Second column heading | |
| Third column heading | Shown when a row has a second value. |
| Show table in a card | |
| Note | |
| Button label | |
| Button link | |
| Image | |
| Image | 1600 x 2000px .jpg recommended. |
| Keep space for the image when empty | |
| Image position | |
| Order on mobile | |
| Image ratio | |
| Show image in a card | |
| Caption | |
Press and logos#
Publications, partners or stockists, as a list, a grid of cards or names in a line. Each entry is a logo or a name set as a wordmark.
Blocks:
- Name or logo: Logo, Logo height, Name, Line beside the name, Link.
- Also accepts app blocks.
Settings of Press and logos
| Setting | What it does |
|---|---|
| Names that vouch for the store: publications, journals, partners, stockists. Add a logo to each, or let the name stand as a wordmark. Say plainly what each one did. | |
| Size | Small is a compact list. Medium sets the names at heading size. Large gives each name a tall row. |
| Layout | |
| Label | |
| Heading | |
| Note | Small print under the label, for example that no publication endorses the store. |
| Columns on desktop | Columns of the list or of the grid. |
| Columns on mobile | |
| Show logos in gray | |
Testimonials#
Quotes from customers, with a name and an optional portrait and source.
Blocks:
- Quote: Quote, Name, Detail, Portrait, Source, Source link, Image shape.
- Also accepts app blocks.
Settings of Testimonials
| Setting | What it does |
|---|---|
| Quiet quotes: the words at reading size, the name in the label font. Use real quotes from real customers. | |
| Size | Small sets the quotes at body size. Medium sets them at reading size. Large sets them at heading size, 2 a row on desktop. |
| Label | A short line above the heading, set in the label font. |
| Heading | |
| Text | |
| Heading alignment | |
| Heading position | Pinned: on desktop the heading stays in view on one side while the content scrolls in the reading column on the other, as the gallery and column of the product page do. On mobile the heading comes first. |
| Layout | |
| Style | |
| Columns on desktop | |
| Columns on mobile | |
| Show quotation marks | |
| Alignment | |
| Note | Small print under the quotes, such as how they were collected. |
Creator videos#
Vertical videos made by customers or creators. Tiles show a poster and a press opens a full-screen player. Names and labels are what you type: the theme adds no rating and no verified mark.
Blocks:
- Clip: Video, YouTube or Vimeo link, Poster image, Name or handle, Label, Caption, Product, Captions file.
- Also accepts app blocks.
Settings of Creator videos
| Setting | What it does |
|---|---|
| Vertical videos made by customers or creators. Tiles show an image; a press opens a full-screen player. Names and labels are what you type: the theme adds no rating and no "verified" mark. | |
| Size | Small is a row of little tiles without names. Medium shows names. Large has bigger tiles and fewer of them across. |
| Layout | |
| Width | Applies to the strip and the row. |
| Clip position | Applies to the leading clip layout on desktop. |
| Autoplay silent previews | The tiles in view loop without sound, like GIFs, with a small pause control on each tile. Never under reduced motion or data saving. |
| Label on clips | A small word on each clip, such as Creator or Customer. Say what is true: do not present paid content as a customer review. |
| Source | Product metafield works on a product page: it reads custom.videos on that product. Accepted types: a list of files holding videos, or a list of metaobject entries with the fields video, poster, creator, label, caption, product. On other pages, and for a product without it, the clip blocks are shown. |
| Heading | |
| Label | A short line above the heading, set in the label font. |
| Heading | |
| Text | |
| Heading alignment | |
| Button label | |
| Button link | |
Before and after#
Two images of the same view under one slider. Use two images in the same ratio.
Settings of Before and after
| Setting | What it does |
|---|---|
| Two images of the same view under one slider: before and after, with and without, day and night. Show only what is true of the product and say under what conditions. | |
| Size | Sets the space above and below the section: small is tight, medium is the default, large is airy. |
| Label | |
| Heading | |
| Text | |
| Images | |
| First image | Both images in the same ratio. 2400 x 1600px .jpg recommended. |
| First label | |
| Second image | |
| Second label | |
| Image ratio | |
| Starting position | |
| Width | |
| Note | |
Comparison table#
A table that compares two or three options row by row, drawn like a product label. One option can be highlighted.
Blocks:
- Row: Label, First option value, Second option value, Third option value.
- Group heading: Heading.
Settings of Comparison table
| Setting | What it does |
|---|---|
| A table drawn like a product label: a heavy rule under the headings, hairlines between rows, a dotted leader after each label. | |
| Size | Small is a narrow table with tight rows and no images. Medium is the standard table. Large sets the option names at heading size and gives the rows more room. |
| Label | A short line above the heading, set in the label font. |
| Heading | |
| Text | |
| Heading alignment | |
| Heading position | Pinned: on desktop the heading stays in view on one side while the content scrolls in the reading column on the other, as the gallery and column of the product page do. On mobile the heading comes first. |
| Columns | |
| Caption | A short line above the table that says what it compares. |
| Heading of the first column | |
| First option name | |
| Second option name | |
| Third option name | Leave empty to compare two options. |
| Image for the first option | 600 x 600px .jpg recommended |
| Image for the second option | |
| Image for the third option | |
| Highlight | |
| Use the reading column width | |
| Style | |
| Alignment of values | |
| Note | Small print under the table. |
Story and explanation#
Image with text#
An image or video beside a heading, text, optional rows of facts and up to two links. The image can carry a small label with a figure.
Settings of Image with text
| Setting | What it does |
|---|---|
| Size | Small gives the image a third of the row and hides the label on the image. Medium follows the column widths set below. Large gives the image more of the row. |
| Image | 2000 x 1500px .jpg recommended |
| Video | Shown over the image, which stays its poster. |
| Video plays as | A loop plays by itself while on screen and has a pause button. A player waits for the play button and then shows its controls. |
| YouTube or Vimeo link | Loads only when a visitor presses play. An uploaded video is used first. |
| Layout | |
| Image position | |
| Order on mobile | |
| Column widths | |
| Image ratio | |
| Vertical position | |
| Show image in a card | |
| Keep image in view beside long text | |
| Move image slightly while scrolling | |
| Label on the image | |
| Label on the image | |
| Figure | One number or word. Leave the figure and its line empty to hide the label. |
| What the figure measures | |
| Label position | |
| Text | |
| Label | A short line above the heading, set in the label font. |
| Heading | |
| Text | |
| Text alignment | |
| Facts | One per line, as Label: value. They are drawn as rows with a dotted leader. |
| Buttons | |
| Button label | |
| Button link | |
| Button style | |
| Link label | |
| Link | |
Image story#
A row of images that sums up a longer story and links to its page.
Blocks:
- Image: Image, Video loop, Label, Figure, Label position, Caption, Link.
- Also accepts app blocks.
Settings of Image story
| Setting | What it does |
|---|---|
| A row of images that sums up a longer story and leads to its page. | |
| Size | Small hides the captions. Medium is the standard row. Large shows 2 images a row on desktop, with larger captions. |
| Label | A short line above the heading, set in the label font. |
| Heading | |
| Text | |
| Heading alignment | |
| Layout | |
| Columns on desktop | |
| Columns on mobile | |
| Image ratio | |
| Show images in a card | |
| Swipe on mobile | When off, images stack on mobile. |
| Link | |
| Link label | |
| Link | |
Timeline#
A story told in chapters: the history of a brand, how a product is made, a journey in dates. With Pinned image, chapters scroll, the image changes to the chapter being read.
Blocks:
- Chapter: Year or label, Heading, Text, Image, Silent loop, Link label, Link.
- Also accepts app blocks.
Settings of Timeline
| Setting | What it does |
|---|---|
| A story told in chapters: the history of the brand, how a product is made, a journey in dates. Each chapter is a block with a year or label, a heading, a text and an image or a silent loop. Works from 2 to 12 chapters, with or without images. | |
| Size | Small is a compact list. Medium is the standard. Large gives the pinned image the full height of the screen and sets headings larger. |
| Label | |
| Heading | |
| Text | |
| Layout | |
| Layout | With the pinned image, the image changes to the chapter being read. On mobile every layout stacks, each chapter under its image; the horizontal timeline stays a row to swipe. |
| Pinned image side | |
| Image side | |
| Image ratio | |
| Show chapters as cards | |
| Show the year or label large | |
| Number the chapters | |
| Closing | |
| Button label | |
| Button link | |
| Note | |
Steps#
How to use a product, or how an order works, as numbered steps joined by a line.
Blocks:
- Step: Icon, Image, Label, Heading, Figure, Text.
- Also accepts app blocks.
Settings of Steps
| Setting | What it does |
|---|---|
| How to use the product, or how an order works, as numbered steps joined by a line that draws as they arrive. | |
| Size | Small is a row of numbered headings. Medium adds text and images. Large stacks the steps with large numbers. |
| Heading | |
| Label | |
| Heading | |
| Text | |
| Heading alignment | |
| Heading position | Pinned: on desktop the heading stays in view on one side while the content scrolls in the reading column on the other, as the gallery and column of the product page do. On mobile the heading comes first. |
| Layout | |
| Layout | Applies when the heading sits above. With a pinned heading the steps are stacked in the column. Steps always stack on mobile. |
| Marker | Icons are set on each step. The line between steps stays. |
| Style | |
| Show images | |
| Image ratio | |
| Show images in a card | |
| Note | |
| Button label | |
| Button link | |
Stage and column#
The product page pattern for your own content: a stage of pictures, videos and drawn slides pinned on one side while a column of blocks scrolls on the other. Add slides in the Gallery slides region and content in the column. With Change the slide as the column scrolls on, each Chapter block names the slide to show as it passes the middle of the screen.
Slides you can add to the stage: Image slide, Video slide, 3D model slide, Figure slide, Text slide and Picture with points. A picture with points carries numbered points that open a panel about a product or scroll the column to a chapter.
Blocks:
- Also accepts any theme block and app blocks.
Settings of Stage and column
| Setting | What it does |
|---|---|
| A stage of pictures, videos and drawn slides pinned on one side while a column of blocks scrolls on the other. Add slides in the Gallery slides region and content in the column. | |
| Size | Small is a square stage that scrolls with the page. Medium pins the stage at the height of the screen. Large gives the stage more width and the column more air. |
| Stage | |
| Name for screen readers | |
| Position on desktop | |
| Pin the stage while the column scrolls | Medium and large sizes. Turn off for a stage with a ratio of its own. |
| Ratio when not pinned | |
| Change the slide as the column scrolls | Each chapter block names the slide it shows. The slide changes when the chapter passes the middle of the screen. Visitors can still change slides themselves. |
| Media fit | |
| Height on mobile | |
| Show previews | |
| Enable image zoom | |
Gallery#
A set of images as a grid, a mosaic with one image leading, or a strip that scrolls sideways. With Open images full screen on, a press opens a viewer.
Blocks:
- Image: Image, Label, Caption, Link, Width in the grid.
- Also accepts app blocks.
Settings of Gallery
| Setting | What it does |
|---|---|
| A set of images as a grid, a mosaic with one image leading, or a strip that scrolls sideways. | |
| Size | Small is a strip of small images. Medium is the chosen layout. Large gives two images a row and larger captions. |
| Heading | |
| Label | |
| Heading | |
| Text | |
| Heading alignment | |
| Layout | |
| Layout | |
| Width | |
| Columns on desktop | |
| Columns on mobile | Applies to the grid. |
| Image ratio | |
| Space between images | |
| Show images in a card | |
| Show captions | |
| Open images full screen | A press opens the image in a full-screen viewer with the other images of the gallery. An image with a link follows its link instead. |
| Button label | |
| Button link | |
Multicolumn#
Columns of short content, each with an image, an icon or a number above it. The Team variation starts with portrait images.
Blocks:
- Column: Image, Icon, Label, Heading, Text, Link label, Link.
- Also accepts app blocks.
Settings of Multicolumn
| Setting | What it does |
|---|---|
| Size | Small hides the images and sets each column under a line. Medium is the standard grid. Large shows 2 columns a row on desktop, with taller images. |
| Label | A short line above the heading, set in the label font. |
| Heading | |
| Text | |
| Heading alignment | |
| Heading position | Pinned: on desktop the heading stays in view on one side while the content scrolls in the reading column on the other, as the gallery and column of the product page do. On mobile the heading comes first. |
| Layout | |
| Columns on desktop | |
| Columns on mobile | |
| Swipe on mobile | When off, columns stack on mobile. |
| Style | |
| Above each item | Choose images, icons from the theme set, numbers, or text alone. Icons and images are set on each block. |
| Icon style | |
| Image ratio | |
| Alignment | |
| Button | |
| Button label | |
| Button link | |
Detail cards#
Small cards that each open a panel with the full detail. The panel slides up from the bottom on mobile and opens at the right edge on desktop. Use them to keep a page short and let visitors go deeper where they choose.
Blocks:
- Card: Heading, Icon, Image, Panel label, Panel heading, Figure, What the figure measures, Text, Source, Source link, Link label, Link.
- Also accepts app blocks.
Settings of Detail cards
| Setting | What it does |
|---|---|
| Small cards that open a panel with the full detail. The panel slides up on mobile and opens at the right edge on desktop. | |
| Size | Small shows compact rows without the round windows. Medium shows the cards. Large has larger windows and labels on desktop. |
| Label | A short line above the heading, set in the label font. |
| Heading | |
| Text | |
| Heading alignment | |
| Heading position | Pinned: on desktop the heading stays in view on one side while the content scrolls in the reading column on the other, as the gallery and column of the product page do. On mobile the heading comes first. |
| Columns on desktop | |
| Layout | Tiles become rows on mobile. Small is always rows. |
Next steps#
Cards that lead somewhere else: the next page to read, a collection, the contact page. Two or three at the foot of a page give a visitor a way on.
Blocks:
- Door: Image, Icon, Label, Heading, Text, Link.
- Also accepts app blocks.
Settings of Next steps
| Setting | What it does |
|---|---|
| Large or small cards that lead somewhere else: the next page to read, a collection, a contact page. Use two or three at the foot of a page so a visitor always has a way on. | |
| Size | Small shows compact rows with a heading and an arrow, without images or text. Medium shows cards. Large shows tall cards with large headings. |
| Label | A short line above the heading, set in the label font. |
| Heading | |
| Text | |
| Heading alignment | |
| Heading position | Pinned: on desktop the heading stays in view on one side while the content scrolls in the reading column on the other, as the gallery and column of the product page do. On mobile the heading comes first. |
| Large cards | Each card takes a large title, an arrow in a disc and, with two cards or fewer a row, its image beside the text. |
| Columns on desktop | |
| Columns on mobile | |
| Style | |
| Above each item | Choose images, icons from the theme set, or text alone. Icons and images are set on each block. |
| Icon style | |
| Image ratio | |
Utility#
Questions#
Questions that open in place, grouped in one card per category. Add a Category block, then the Question blocks that belong to it. With Add questions to search engine data on, the questions are added to the page's structured data. Turn it off on all but one questions section per page.
Blocks:
- Category: Heading.
- Question: Question, Answer, Show open by default.
- Also accepts app blocks.
Settings of Questions
| Setting | What it does |
|---|---|
| Questions that open in place, grouped in one card per category. Add a category block, then the question blocks that belong to it. | |
| Size | Small is a compact list in the reading column, without the list of categories. Medium is the standard. Large sets the category names at display size, with more space between them. |
| Heading | |
| Text | |
| Layout | |
| Layout | |
| Pinned image | 2000 x 2400px .jpg recommended |
| Pinned image side | |
| Show list of categories | A row of buttons on mobile and a list that stays in view on desktop. |
| Center the questions | |
| Add questions to search engine data | Turn this off when another questions section on the same page already adds its questions to search results. |
| Note | Small print under the last category. |
Email signup#
A heading, a text and an email field. Signups are added to your customer list in Shopify as email subscribers.
Settings of Email signup
| Setting | What it does |
|---|---|
| Signups add customers to your customer list with the newsletter tag. | |
| Size | Small sets the text and the field side by side on desktop, with a smaller field and no icon. Medium is one column. Large widens the column. |
| Label | |
| Heading | |
| Text | |
| Button label | |
| Note | Small print under the field, such as a link to your privacy policy. |
| Alignment | |
| Style | |
| Icon | Shown above the label. |
Contact form#
A contact form with name, email and message, and an optional phone field. Messages are sent to the store contact email set in your Shopify admin. The text beside the form can list contact details, one per line as Label: value.
Settings of Contact form
| Setting | What it does |
|---|---|
| Size | Small is one narrow column without the contact details. Medium is the chosen layout. Large sets the form in a card. |
| Text | |
| Label | |
| Heading | |
| Text | |
| Contact details | One per line, as Label: value. Email addresses become links. |
| Form | |
| Show phone number field | The phone number is optional for the customer. |
| Button label | |
| Note | Small print beside the button, such as how you use the details. |
| Layout | |
| Layout | |
| Pinned image | 2000 x 2400px .jpg recommended. A photograph of the store or a saved image of a map. |
| Pinned image side | |
| Order on mobile | |
| Alignment | |
| Show form in a card | |
Store information#
An address, opening hours and one image for each location, for stores with a physical place.
Blocks:
- Location: Label, Icon, Name, Address, Hours heading, Hours, Phone number, Email, Link label, Link, Image.
- Also accepts app blocks.
Settings of Store information
| Setting | What it does |
|---|---|
| An address, opening hours and one image for each location. The image can be a photograph of the store or a saved image of a map. | |
| Size | Small shows the text alone, without the image. Medium sets the image beside the text. Large sets a tall image above the text on desktop. |
| Label | A short line above the heading, set in the label font. |
| Heading | |
| Text | |
| Heading alignment | |
| Image position | |
| Show image | Turn off for a card of text alone. |
| Order on mobile | |
| Style | |
Delivery and returns#
States delivery, returns and the guarantee from Theme settings > Delivery and returns, so the page always says what the product page, the cart and the footer say. Add rows for regions, delivery times or costs.
Blocks:
- Row: Label, Note, Value.
- Group heading: Heading.
- Also accepts app blocks.
Settings of Delivery and returns
| Setting | What it does |
|---|---|
| States delivery, returns and the guarantee from Theme settings > Delivery and returns, so the page always says what the product page, the cart and the footer say. Add rows for regions, delivery times or costs. | |
| Size | Small shows compact cards without icons. Medium is the standard. Large shows taller cards with more room. |
| Label | |
| Heading | |
| Text | |
| From the theme settings | |
| Show delivery | |
| Show returns | |
| Show guarantee | |
| Show the summary rows | Shipping, delivery time, return window and guarantee as rows of the table. |
| Table | |
| Table heading | |
| Note | |
| Show links to the policies | |
| Extra link label | |
| Extra link | |
Table#
A plain table for a size guide, a dose guide, dimensions or opening hours. Write one row per line and separate cells with a vertical bar, for example Small | 96 cm | 68 cm.
Settings of Table
| Setting | What it does |
|---|---|
| A plain table for a size guide, a price list, dimensions or opening hours. Write one row per line and separate the cells with a vertical bar. | |
| Size | Sets the space above and below the section: small is tight, medium is the default, large is airy. |
| Label | |
| Heading | |
| Text | |
| Table | |
| Rows | One row per line. Separate cells with |. |
| First row is the header | |
| First column names the row | |
| Caption | |
| Show in a card | |
| Width | |
| Note | |
Divider#
A quiet break between two parts of a page: a hairline, a dotted line, a label in the line, an aurora line, a numbered chapter mark or space only.
Settings of Divider
| Setting | What it does |
|---|---|
| A quiet break between two parts of a page. The line draws from the left when it comes on screen. | |
| Size | The space around the line: small, medium or large. |
| Style | |
| Label | |
| Number | For example 02. |
| Label position | |
| Width | |
Custom section#
A blank section that accepts any theme block. Arrange blocks as a stack, a grid, two columns or a row. Use it when no ready-made section fits. The blocks are listed under Theme blocks.
Blocks:
- Also accepts any theme block and app blocks.
Settings of Custom section
| Setting | What it does |
|---|---|
| A blank part of a page. This theme reads as one narrow column with a lot of air between groups: start from a preset, then add blocks. | |
| Size | Sets the scale of the whole section. Small is compact: figures sit on one line, logos are a quiet strip, cards are rows. Medium is the standard page. Large gives a figure or a trailer line the whole screen. |
| Layout | |
| Width | The reading column is the content width set in the theme settings, 520 px by default. |
| Column position | Where a reading column or a wide column sits on desktop. |
| Arrangement | Two columns puts the first block on one side and the second on the other, as on the product page. Group blocks to put several on one side. |
| Spacing between blocks | Page rhythm is the space this theme leaves between groups. It follows the size of the section. |
| Alignment | |
| Vertical alignment | |
| Columns on desktop | |
| Columns on mobile | |
| Column widths | With a reading column, the other side takes the rest of the page, as the gallery does on the product page. |
| Keep in view while scrolling | On desktop that side stays in place while the other scrolls. |
| Show the second column first on mobile | |
| Look | |
| Show a line above | |
Custom Liquid#
A place for Liquid code or an app snippet. See the note on custom code in the support policy.
Settings of Custom Liquid
| Setting | What it does |
|---|---|
| Liquid code | Add app snippets or other code to create advanced customizations. |
| Size | Sets the scale of the whole section. Small is compact: figures sit on one line, logos are a quiet strip, cards are rows. Medium is the standard page. Large gives a figure or a trailer line the whole screen. |
| Width | |
| Column position |
Apps#
A section that holds app blocks only, for apps that add content to a page. See Apps.
Settings of Apps
| Setting | What it does |
|---|---|
| Size | The space above and below the apps. |
| Full width |
Theme blocks#
Theme blocks are the building pieces of the Custom section, the Stage and column section, the product page and any block that accepts other blocks, such as Group and Detail card.
Group#
A container that lays out the blocks inside it as a stack, a row or a grid, with an optional surface behind them. Put groups inside groups to build columns.
Settings of Group
| Setting | What it does |
|---|---|
| Layout | A stack sets blocks one under the other. A row sets them side by side and wraps. Two columns sit side by side on desktop and stack on mobile. |
| Spacing between blocks | |
| Alignment | |
| Vertical alignment | |
| Distribution | |
| Stack on mobile | |
| Columns on desktop | |
| Columns on mobile | |
| Column widths | |
| Show the second column first on mobile | |
| Width | |
| Surface | |
| Surface | A rim card is white inside a gray rim. A well is pressed gray and holds controls. Use glass only over images. |
| Padding | |
| Behavior | |
| Keep in view while scrolling | On desktop the group stays in place while a taller column scrolls beside it. |
| Link | Makes the whole group a link. Leave empty when the group holds buttons or links of its own. |
Heading#
A heading with a size, a level and an alignment.
Settings of Heading
| Setting | What it does |
|---|---|
| Heading | |
| Size | Page title is 40 px on desktop, display 28 px, section title 20 px. Trailer sizes grow with the screen. |
| Heading level | Sets the place of the heading in the page outline, not its look. |
| Alignment | |
| Line length | Set to 0 to use the full width. |
| Add an asterisk | The asterisk links to the Footnote block on the page. |
Text#
Rich text at body or reading size, in one or two columns.
Settings of Text
| Setting | What it does |
|---|---|
| Text | To attach a note to a few words, select them, add a link and enter #note- followed by the handle of a Source or note block on this page. |
| Size | |
| Line length | |
| Alignment | |
| Use the secondary text color | |
| Use 2 columns on desktop | |
| Link asterisks to the footnote | Each asterisk becomes a link to the Footnote block on the page. |
Label#
A short line in the label font, with an optional icon.
Settings of Label
| Setting | What it does |
|---|---|
| Label | |
| Icon | |
| Heading level | |
| Alignment | |
| Use the secondary text color | |
| Show a line above | The line draws from the left when the label arrives. |
Image#
An image with a shape, a ratio, an optional rim card frame, a caption and a link.
Settings of Image
| Setting | What it does |
|---|---|
| Image | 2400 x 1600px .jpg recommended. Set the focal point on the image to choose what stays in view when it is cropped. |
| Alternative text | Describe the image for people who cannot see it. Uses the alt text of the image when empty. |
| Shape | A porthole is a round window with a white ring. |
| Image ratio | |
| Image fit | |
| Porthole size | |
| Width | |
| Alignment | |
| Frame | |
| Show in a rim card | A gray rim around the image, as on the cards. |
| Corners | |
| Caption | |
| Link | |
| Behavior | |
| Keep in view while scrolling | On desktop the image stays in place while a taller column scrolls beside it. |
| Space on desktop | Helps the browser choose the right file size. |
| Load first | Turn on for an image at the top of the page. |
Video#
An uploaded or external video, as a silent loop or a player.
Settings of Video
| Setting | What it does |
|---|---|
| Video | A video uploaded to your store. It replaces the external video. |
| Play as | A player shows the cover image and a play button, then the controls of the browser. A silent loop plays by itself while it is on screen, pauses off screen, has a pause button and never starts when the visitor asks for reduced motion. |
| External video | A YouTube or Vimeo link. With a cover image, the video loads only when the visitor presses play. |
| Video description | Describes the video for people who cannot see it. |
| Cover image | 1600 x 900px .jpg recommended. Uses the first frame of an uploaded video when empty. |
| Shape | |
| Aspect ratio | |
| Porthole size | |
| Alignment | |
| Show in a rim card | |
| Keep in view while scrolling | |
| Caption |
Button#
One button with a style, an optional arrow and an optional line under it.
Settings of Button
| Setting | What it does |
|---|---|
| Button label | |
| Link | |
| Note handle | Enter the handle of a Source or note block on this page to open its bubble. The note opens instead of the link. |
| Style | Use solid for the one main action of a page. Quiet sits in the gray of the wells, paper is white with a soft shadow, outline is a clear button with a 1 px line that fills on hover. |
| Alignment | |
| Use the large size | |
| Use the full width | |
| Show arrow | |
| Arrow | |
| Open link in a new tab | |
| Line under the button | Use it for one reassurance, such as the shipping time. |
Figure#
One number, alone, with the line that says what it measures. It can count up and can carry a small bar chart.
Settings of Figure
| Setting | What it does |
|---|---|
| One number, alone, with the line that says what it measures. Add a Source or note block inside to show where it comes from. | |
| Benefit | |
| Benefit label | |
| Icon | |
| Figure | |
| Prefix | A sign or a currency symbol before the number. |
| Value | |
| Unit | Set small after the number, such as %, kg or days. |
| Count up to the figure | The number runs up to its value once, when it comes on screen. Follows the motion setting of the theme. |
| Size | Large is up to 128 px. Use words for a short phrase instead of a number. |
| Add an asterisk | The asterisk links to the Footnote block on the page. |
| Line | |
| Text | |
| Keep the line short | Limits the line to 36 characters. |
| Use the secondary text color | |
| Chart | |
| Bars | Add one bar per line, as a label, a colon and a number. End a line with an asterisk to draw its bar in the text color. Leave empty for no chart. |
| Chart caption | Say what the bars measure and in which unit. |
| Alignment | |
Fact label#
Facts set like a product label: a heading on a thick rule and rows with dotted leaders. Rows are typed one per line as Label: value. It can be made collapsible.
Settings of Fact label
| Setting | What it does |
|---|---|
| Facts set like a product label: a heading on a thick rule, then rows with a dotted leader between the name and the value. | |
| Heading | |
| Rows | Add one row per line. Separate the label and the value with a colon. A line without a colon starts a new group with that line as its heading. |
| Line under the rows | |
| Set the last row as a total | |
| Show in a rim card | |
| Collapsible | |
| Make collapsible | |
| Show open by default | |
| First statement | A short pill in the closed row. |
| First explanation | |
| Second statement | |
| Second explanation | |
Collapsible row#
A row that opens to show text or other blocks.
Settings of Collapsible row
| Setting | What it does |
|---|---|
| Heading | |
| Text | |
| Style | Rows that follow each other share one line. Put chevron rows in a Group set to a rim card to get the look of the Questions block. |
| Show open by default | |
| Link asterisks to the footnote | Each asterisk becomes a link to the Footnote block on the page. |
Detail cards#
A set of Detail card blocks side by side or as rows.
Settings of Detail cards
| Setting | What it does |
|---|---|
| Cards that each open a panel with the full story. Keep the page light and let people go deep where they choose to. | |
| Heading | |
| Layout on desktop | On mobile the cards are always rows. |
| Columns on desktop | |
| Large cards | Larger windows, names and spacing. Off, the cards keep their standard size. |
Detail card#
A card that opens a panel. The panel can hold blocks, the content of a page, one entry of a product metafield, or the delivery and returns statements from the theme settings. With a Link, the card goes to that link and opens no panel.
Settings of Detail card
| Setting | What it does |
|---|---|
| A card that opens a panel: a sheet from the bottom on mobile, a panel on the right edge on desktop. Use the Detail cards block to set several side by side. | |
| Heading | |
| Line under the heading | |
| Icon | |
| Porthole image | A small round window on the card. 480 x 480px .jpg recommended. Without an image or a video, the window holds the icon. |
| Porthole video loop | A short loop without sound, played while the card is on screen. Visitors can pause it, and it never starts when they ask for reduced motion. A square video of 480 x 480px, under 20 seconds, works best. |
| Link | With a link, the card goes there and opens no panel. Leave empty to open the panel. |
| Panel | |
| Content | Delivery and returns writes itself from the theme settings and your store policies. Product metafield reads one entry of custom.detail_cards on the product of the page: a list of single line text written Title | Text, or a list of metaobject entries with the fields title, subtitle, icon, image, body. The entry's title replaces the card heading. A product without it shows the blocks inside this card. |
| Page | |
| Entry to show | The position of the entry in the product metafield: 1 is the first. |
| Text before the content | |
| Panel label | Uses the card heading when empty. |
| Panel heading | Uses the card heading when empty. |
| Show the porthole beside the heading | |
| Use the full height | Keeps the panel the same size when rows open and close. |
| Side on desktop | |
Questions#
Questions in tabs. Each Tab is one card of Question blocks.
Settings of Questions
| Setting | What it does |
|---|---|
| Questions in tabs. Each tab is one card and all tabs share one place on the page, so changing tab never moves what is below. With one tab, the tabs are hidden. | |
| Heading | |
| Heading level | |
| Name of the tabs | Read by screen readers when the heading is empty. |
| Stretch the tabs to the full width | Turn on for 3 tabs or more, or for long tab names. |
| Alignment | |
| Link under the questions | |
| Link label | |
| Link | |
| Search engines | |
| Add FAQ structured data | Built from the questions and answers as they are shown. Turn it on for one Questions block per page. |
Ingredient list#
Ingredients or materials as label rows: a name, an amount and what it does. Type the rows in the block, or let each product bring its own. See Custom data.
Settings of Ingredient list
| Setting | What it does |
|---|---|
| Ingredients or materials as label rows: a name, an amount and what it does. Type them here, or let each product bring its own from a product metafield. Without any row, the block prints nothing. | |
| Heading | |
| Source | Product metafield reads custom.ingredients on the product of the page. Accepted types: list of single line text written Name | Amount | Note; multi-line text with one row per line; or a list of metaobject entries. A product without it shows the rows typed below. |
| Rows | One ingredient per line, written Name | Amount | Note. The note is optional and sits under the name. |
Evidence list#
Claims as rows that open, each closing on its source. Type the rows in the block, or let each product bring its own.
Settings of Evidence list
| Setting | What it does |
|---|---|
| Claims as rows that open, each closing on its source. Type them here, or let each product bring its own from a product metafield. Without any row, the block prints nothing. | |
| Heading | |
| Source | Product metafield reads custom.claims on the product of the page. Accepted types: list of single line text written Statement | Detail | Source | Source link; multi-line text with one row per line; or a list of metaobject entries. A product without it shows the rows typed below. |
| Rows | One claim per line, written Statement | Detail | Source | Source link. Everything after the statement is optional. State only what you can support, and name the source. |
| Maximum claims to show | |
Question list#
Questions and answers as rows that open. Type the rows in the block, or let each product bring its own.
Settings of Question list
| Setting | What it does |
|---|---|
| Questions and answers as rows that open. Type them here, or let each product bring its own from a product metafield. Without any row, the block prints nothing. | |
| Heading | |
| Source | Product metafield reads custom.faq on the product of the page. Accepted types: list of single line text written Question | Answer; multi-line text with one row per line; or a list of metaobject entries. A product without it shows the rows typed below. |
| Rows | One question per line, written Question | Answer. |
| Maximum questions to show | |
| Show the first answer open | |
| Add structured data for search engines | Turn on for one questions block a page at most. |
Story#
A brand or maker story: a label, a heading, an image and text.
Settings of Story
| Setting | What it does |
|---|---|
| A brand or maker story: a label, a heading, an image and text. Type it here, or let each product bring its own from a product metafield. | |
| Source | Product metafield reads custom.story on the product of the page. Accepted types: rich text or multi-line text (it replaces the text below, under the heading typed here), or one metaobject entry with the fields title, kicker, image, lead, body. A product without it shows the text typed below. |
| Label | |
| Heading | |
| Image | 1400 x 1050px .jpg recommended. |
| Text | |
| Show the image | |
Statements#
Short pills that each state one fact. A statement with an explanation shows it in a bubble on hover, focus and tap.
Settings of Statements
| Setting | What it does |
|---|---|
| Short pills that each state one fact. An explanation shows in a small glass bubble on hover, on keyboard focus and on tap. Statements open nothing else. | |
| Label | |
| Size | |
| Alignment | |
Statement line#
A few large words, used as a closing line.
Settings of Statement line
| Setting | What it does |
|---|---|
| A few big words, like the last card of a film trailer, with the line and the source that back them. | |
| Words | |
| Size | |
| Heading level | |
| Add an asterisk | The asterisk links to the Footnote block on the page. |
| Line | |
| Alignment | |
Progress thread#
A line drawn from a first step to a last one, for a change over time.
Settings of Progress thread
| Setting | What it does |
|---|---|
| A line from a first step to a last one, drawn once when it comes on screen, with a figure that changes once on the way. Use it for what happens over time: a routine, a delivery, a warranty. | |
| Benefit | |
| Benefit label | |
| Icon | |
| Figure | |
| Start value | |
| End value | |
| Unit | |
| Size | |
| Add an asterisk | The asterisk links to the Footnote block on the page. |
| Text | |
| Steps | |
| Steps | Add one step per line, 2 to 6 steps. Add a colon and a few words to describe a step. |
| Direction | Use top to bottom for more than 4 steps or for longer descriptions. |
| Line drawn | How far the dark line goes. Use less than 100% to show progress so far. |
| Alignment | |
Logo cards#
Logos as a grid of cards: press, stockists or certifications.
Settings of Logo cards
| Setting | What it does |
|---|---|
| Logos as a grid of cards: press, stockists, certifications, journals. Each logo sits on the same line and starts at the left edge, whatever its width. | |
| Label | |
| Columns on desktop | |
| Columns on mobile | |
| Line under the cards | Say what the logos mean, and what they do not. |
Email signup#
One email field and one button. Subscribers are added to your customer list.
Settings of Email signup
| Setting | What it does |
|---|---|
| One field and one button in a gray well. Subscribers are added to your customer list with the tags below and accept marketing. | |
| Field label | |
| Button label | |
| Line under the field | |
| Success message | Shown in the field once the address is saved. Uses the theme text when empty. |
| Customer tags | Separate tags with a comma. Use a tag of your own to tell where a subscriber signed up. |
| Look | |
| Size | Large is 68 px tall, at the scale of a trailer line. Compact is 56 px. |
| Stack the field and the button | Under 480 px they always stack, so a full address stays readable. |
| Play the sending animation | A small capsule carries the address to the button while the form is sent. It does not play when the visitor asks for reduced motion. |
Source or note#
A link that opens a bubble with the details behind a statement: what was measured, a small chart and a link to the source.
Settings of Source or note
| Setting | What it does |
|---|---|
| A link that opens a bubble with the details: what a number means, where a claim comes from, how a policy works. The link to the source comes last, inside the bubble. | |
| Handle | A short name, such as study-1. A link in any rich text whose URL is #note-study-1 then opens this note. Buttons and logo cards can open it too. Use each handle once per page. |
| Link | |
| Show as | A small label sits well under a figure. Choose nothing when the note opens from words in a rich text. |
| Link label | |
| Bubble | |
| Label | What kind of note this is, such as Study, Policy or Material. |
| Heading | |
| Subheading | Where it was published, or who says it. |
| Details | Add one row per line. Separate the label and the value with a colon. |
| Large word or number | A verdict or a result, set large. |
| Chart | Add one bar per line, as a label, a colon and a number. End a line with an asterisk to draw its bar in the text color. Leave empty for no chart. |
| Chart caption | Say what the bars measure and in which unit. |
| Details after the chart | Add one row per line. Separate the label and the value with a colon. |
| Text | |
| Small print | |
| Read more | |
| Link to the source | |
| Source link label | |
| Behavior | |
| Position on desktop | On mobile a note is always a sheet from the bottom. |
Sources#
A numbered list of sources.
Settings of Sources
| Setting | What it does |
|---|---|
| Heading | |
| Sources | Add one source per line. To link a source, add a vertical bar and its address after the name. To open a note, add a vertical bar and #note- followed by its handle. |
Footnote#
The line that asterisks on the page link to, for a regulatory statement or a condition.
Settings of Footnote
| Setting | What it does |
|---|---|
| The line every asterisk on the page links to. It lights once when a reader arrives from an asterisk. | |
| Text | |
| Marker | |
| ID | Asterisks added by this theme link to fn. Change it only for a second footnote that you link to yourself. |
| Line length | |
| Alignment | |
Divider#
A line, a label in a line or a chapter mark between blocks.
Settings of Divider
| Setting | What it does |
|---|---|
| Style | |
| Label | |
| Number | For example 02. |
| Label position | |
| Space around |
Spacer#
Empty space of a chosen height.
Settings of Spacer
| Setting | What it does |
|---|---|
| Height | On mobile, 70% of this height is used. The page rhythm of this theme is 112 px between groups on mobile and 160 px on desktop. |
| Show a line |
Product card#
One product as a card, with an optional quick add.
Settings of Product card
| Setting | What it does |
|---|---|
| Product | |
| Card style | |
| Image ratio | |
| Image fit | |
| Quick add |
Custom Liquid#
Liquid code or an app snippet between other blocks.
Settings of Custom Liquid
| Setting | What it does |
|---|---|
| Liquid code | Add app snippets or other code to create advanced customizations. |