Salve sections and blocks

This reference lists every section and theme block in Salve, with each setting as it appears in the theme editor. Settings that you set once for the whole store are in the theme settings reference.

A few things apply almost everywhere:

  • Color scheme picks one of the color schemes you set in theme settings under Colors.
  • Top padding and Bottom padding set the space inside the section. The space is reduced on small screens.
  • Heading level sets the HTML heading level for screen readers and search engines. It doesn't change the size. Most sections use H2.
  • Block spacing on blocks adds space above and below the block.
  • Health blocks show nothing when the product has no data for them, so a product with no health data still looks clean.

Before you change a live theme, duplicate it. See Getting started.

Header and footer

These sections live in the header and footer groups, so they appear on every page. Edit them from any page in the theme editor.

Safety notice bar

A site-wide bar for recalls and field safety notices. It sits above everything else in the header. Turn it on only when you have a notice to publish. See Documents and safety notices.

Use for recalls and field safety notices. Important notices show above everything and can't be dismissed.

Setting Options Default Notes
Show notice On or off Off
Severity Information (can be dismissed), Important (cannot be dismissed) Information (can be dismissed) Information notices can be dismissed by visitors.
Text Rich text Empty
Link Link Empty
Link label Text "Read the notice"
Color scheme Color scheme Scheme 5

Announcement bar

A slim bar with up to three announcements. Shoppers move between announcements with previous and next buttons; they never rotate on their own. The bar can also hold the country and language selectors and the text size control.

Setting Options Default Notes
Color scheme Color scheme Scheme 3
Show country and language selectors On or off On Shows only when your store has more than one country or language.
Show text size control On or off On Requires the text size control in theme settings.

You can add up to 3 blocks.

Announcement block.

Setting Options Default Notes
Text Text "Free shipping on orders over $50"
Link Link Empty

Header

Your logo, menus, search, account and cart. The Menu promotion block adds an image and link to the mega menu.

Setting Options Default Notes
Main menu Menu Main menu
Desktop menu type Dropdown, Mega menu Dropdown
Secondary menu Menu Empty Small links shown beside the icons, for example Help, Documents, Track order.
Customer account menu Menu Customer account main menu
Logo position on desktop Left, Center Left
Sticky header None, On scroll up, Always On scroll up
Search Icon, Search bar Icon
Show HSA/FSA link On or off On Links to the HSA/FSA page set in theme settings.
Show country/region selector On or off On
Show language selector On or off On
Color scheme Color scheme Scheme 1

You can add one block.

Menu promotion block.

Shown in the mega menu beside the first menu with submenus.

Setting Options Default Notes
Image Image Empty
Heading Text "New this season"
Text Text Empty
Link Link Empty

Email signup

Also available in the footer group. See the Email signup entry under home page and content sections.

Footer

Menus, text, contact details, social media icons, an email signup form and an image, such as an accreditation badge you hold. The bottom row shows the copyright line, policy links, payment icons and selectors.

Setting Options Default Notes
Color scheme Color scheme Scheme 2
Show payment icons On or off On
Show policy links On or off On
Show country/region selector On or off On
Show language selector On or off On
Show Follow on Shop button On or off Off Requires the Shop channel.
Section padding
Top padding 0–120 px, in steps of 4 48 px
Bottom padding 0–120 px, in steps of 4 32 px

You can add up to 8 blocks.

Menu block.

Setting Options Default Notes
Heading Text Empty Leave empty to use the menu's title.
Menu Menu Footer menu

Text block.

Setting Options Default Notes
Heading Text "About us"
Text Rich text "Share a short note about your store, your team or how you choose the products you carry."

Contact details block.

Setting Options Default Notes
Heading Text "Contact"
Address Multi-line text Empty
Phone Text Empty
Email Text Empty
Opening hours Text Empty

Social media icons block.

Add your social media links in theme settings.

Setting Options Default Notes
Heading Text "Follow us"

Email signup block. You can add one of these.

Setting Options Default Notes
Heading Text "Stay in touch"
Text Rich text "Product news and reorder reminders. No more than twice a month."
Consent text Rich text "By signing up you agree to receive marketing emails. Unsubscribe anytime."

Image block.

Setting Options Default Notes
Image Image Empty For example an accreditation or membership badge you hold.
Alt text Text Empty
Width 60–300 px, in steps of 10 160 px
Caption Text Empty

Legal information

The small print at the very bottom of every page: your legal company name, registered address, registration numbers, the medical disclaimer and the emergency line.

Small print at the very bottom of every page. Fill in what applies to your business.

Setting Options Default Notes
Legal company name Text Empty
Registered address Multi-line text Empty
Registration numbers Multi-line text Empty For example company registration, VAT or pharmacy registration numbers. One per line.
Show medical disclaimer On or off On Text is set in theme settings under Safety and privacy.
Show emergency line On or off On
Additional text Rich text Empty
Color scheme Color scheme Scheme 2

Home page and content sections

Add these sections to the home page and to most other templates. Each has its own color scheme and top and bottom padding.

Hero

The opening section of the home page, with an image or video and up to seven blocks (headings, text, buttons and icons with text).

Find it in the section picker under Layout.

Setting Options Default Notes
Image Image Empty Also used as the video poster. Recommended 2000 x 1125 px.
Mobile image Image Empty Optional portrait image shown on small screens instead of the main image.
Video Video Empty Plays muted and looped with a visible pause button. It does not autoplay for visitors who prefer reduced motion.
Layout Full width with overlay, Split, image left, Split, image right Full width with overlay
Height Small, Medium, Large, Adapt to image Medium
Overlay opacity 0–80%, in steps of 5 30% Full width layout only. Darkens the media so text stays readable.
Content position Top left, Top center, Top right, Middle left, Middle center, Middle right, Bottom left, Bottom center, Bottom right Middle left Full width layout only, on desktop.
Content alignment Left, Center, Right Left
Color scheme Color scheme Scheme 1
Section padding
Top padding 0–120 px, in steps of 4 0 px
Bottom padding 0–120 px, in steps of 4 0 px

Accepts these blocks: Heading, Text, Button, Icon with text.

You can add up to 7 blocks.

Shop by need

Entry points by need, such as "Blisters" or "Blood pressure". Each tile links to a collection or URL. Use nouns, not claims.

Find it in the section picker under Products.

Setting Options Default Notes
Heading Text "Shop by need"
Heading level H2, H3 H2
Text Rich text Empty
Style Image tiles, Icon tiles, Text pills Image tiles
Columns on desktop 2–6, in steps of 1 4
Columns on mobile 1, 2 2
Image ratio Square, Landscape, Portrait, Wide (16:9) Landscape
Color scheme Color scheme Scheme 1
Section padding
Top padding 0–120 px, in steps of 4 48 px
Bottom padding 0–120 px, in steps of 4 48 px

You can add up to 12 blocks.

Use case block.

Setting Options Default Notes
Image Image Empty Used by the image tiles style.
Icon None, Bandage, Care, Shield, Thermometer, Heart rate, Capsule, Droplet, Leaf, Clipboard, Box, Check Bandage Used by the icon tiles and text pills styles.
Label Text "Blisters" Use a noun such as "Blisters" or "Pressure care", not a claim.
Collection Collection Empty
URL Link Empty Used when no collection is selected.
Description Text Empty

Product list

Products from one collection, shown as a grid or a row with arrows.

Find it in the section picker under Products.

Setting Options Default Notes
Collection Collection Empty
Maximum items 2–24, in steps of 1 8
Layout Grid, Row with arrows Grid
Columns on desktop 2–5, in steps of 1 4
Columns on mobile 1, 2 2
Show "View all" link On or off On
Color scheme Color scheme Scheme 1
Section padding
Top padding 0–120 px, in steps of 4 48 px
Bottom padding 0–120 px, in steps of 4 48 px

Accepts these blocks: Heading, Text, Button.

You can add up to 3 blocks.

Collection list

A grid of collections you choose.

Find it in the section picker under Products.

Setting Options Default Notes
Collections Collections Empty
Columns on desktop 2–5, in steps of 1 3
Columns on mobile 1, 2 2
Image ratio Square, Landscape, Portrait Landscape
Show product count On or off Off
Color scheme Color scheme Scheme 1
Section padding
Top padding 0–120 px, in steps of 4 48 px
Bottom padding 0–120 px, in steps of 4 48 px

Accepts these blocks: Heading, Text.

You can add up to 2 blocks.

Featured product

One product with its media and a short set of product blocks, including safety information.

Find it in the section picker under Products.

Setting Options Default Notes
Product Product Empty
Media position on desktop Left, Right Left
Show "View full details" link On or off On
Color scheme Color scheme Scheme 1
Section padding
Top padding 0–120 px, in steps of 4 48 px
Bottom padding 0–120 px, in steps of 4 48 px

Accepts these blocks: Product title, Regulatory status, Price, Variant picker, Purchase options, Quantity, Buy buttons, HSA/FSA badge, Safety information, App blocks, Custom Liquid.

Product selector

A guided finder that sends shoppers to a filtered collection. See Product selector and filters.

Find it in the section picker under Products.

A guided finder. Each question maps its answers to filter parameters so shoppers land on the collection with those filters applied. Filters must be enabled for the collection in the Search and Discovery app.

Setting Options Default Notes
Collection Collection Empty The collection shoppers are sent to with their filters applied. Defaults to all products.
Heading Text "Find the right dressing"
Anchor link ID Text Empty Lets a button link straight to this section, for example #find-a-dressing. Use letters, numbers and hyphens.
Heading level H2, H3 H2
Introduction Rich text "Answer a few questions and we'll show products that match. This is a shopping aid, not medical advice."
Results button label Text "Show matching products"
Start over label Text "Start over"
Color scheme Color scheme Scheme 1
Section padding
Top padding 0–120 px, in steps of 4 48 px
Bottom padding 0–120 px, in steps of 4 48 px

You can add up to 8 blocks.

Question block.

One answer per line: label, a vertical bar, then the filter parameter, for example "High | filter.p.m.health.exudate_level=High". Copy the parameter from the collection URL after applying the filter. A line with no parameter ("Not sure |") adds no filter.

Setting Options Default Notes
Label Text "What are you looking for?"
Help text Text Empty
Answers Multi-line text "Option A | filter.p.product_type=Foam dressing"; "Option B | filter.p.product_type=Film dressing" Formats: filter.p.m.namespace.key=Value (metafield), filter.v.option.size=Large (variant option), filter.p.product_type=Foam dressing (product type), filter.p.tag=latex-free (tag).

Comparison table

A fixed comparison of up to four products you choose. See Product comparison and specifications.

Find it in the section picker under Products.

Setting Options Default Notes
Heading Text "Compare products"
Heading level H2, H3 H2
Introduction Rich text Empty
Products Products Empty
Specification rows Multi-line text "Pad size"; "Wear time"; "Sterile"; "Latex-free" One label per line, matching the labels in each product's specifications metafield. Rows with no data for any product are hidden.
Show price row On or off On
Show add to cart row On or off On
Color scheme Color scheme Scheme 1
Section padding
Top padding 0–120 px, in steps of 4 48 px
Bottom padding 0–120 px, in steps of 4 48 px

Quick order list

A table of variants with quantity fields, so regular customers can add several items to the cart in one step.

Find it in the section picker under Products.

Setting Options Default Notes
Heading Text "Quick order"
Heading level H2, H3 H2
Text Rich text "Enter quantities for the items you use regularly and add them to your cart in one step."
Collection Collection Empty Every variant of every product in the collection gets a row (up to 50 products). Ignored when specific products are chosen below.
Products Products Empty Choose specific products instead of a collection.
Show product images On or off On
Show SKU column On or off On
Color scheme Color scheme Scheme 1
Section padding
Top padding 0–120 px, in steps of 4 48 px
Bottom padding 0–120 px, in steps of 4 48 px

Rich text

Headings, text and buttons without an image.

Find it in the section picker under Content.

Setting Options Default Notes
Width Narrow, Medium, Wide Medium
Content alignment Left, Center Left
Color scheme Color scheme Scheme 1
Section padding
Top padding 0–120 px, in steps of 4 48 px
Bottom padding 0–120 px, in steps of 4 48 px

Accepts these blocks: Heading, Text, Button.

Image with text

An image beside headings, text, buttons and icons with text.

Find it in the section picker under Content.

Setting Options Default Notes
Image Image Empty
Image width One third, One half, Two thirds One half
Image position Left, Right Left
Vertical alignment Top, Middle, Bottom Middle
Color scheme Color scheme Scheme 1
Section padding
Top padding 0–120 px, in steps of 4 48 px
Bottom padding 0–120 px, in steps of 4 48 px

Accepts these blocks: Heading, Text, Button, Icon with text.

Multicolumn

Up to six columns, each with an icon or image, a heading, text and a link.

Find it in the section picker under Content.

Setting Options Default Notes
Heading Text "What to expect from us"
Heading level H2, H3 H2
Text Rich text Empty
Style Cards, Plain Cards
Columns on desktop 2–4, in steps of 1 3
Columns on mobile 1, 2 1
Image ratio Square, Landscape, Portrait, Wide (16:9) Landscape
Color scheme Color scheme Scheme 1
Section padding
Top padding 0–120 px, in steps of 4 48 px
Bottom padding 0–120 px, in steps of 4 48 px

You can add up to 6 blocks.

Column block.

Setting Options Default Notes
Image Image Empty When an image is set it replaces the icon.
Icon None, Check, Shield, Truck, Box, Refresh, Calendar, Clipboard, Care, Document, Lock, Phone, Mail, Info, Clock, Globe Check
Heading Text "Column heading"
Text Rich text "Describe one thing customers can rely on, in plain words."
Link Link Empty
Link label Text "Learn more"

Image gallery

Up to 12 images with optional captions and links.

Find it in the section picker under Media.

Setting Options Default Notes
Heading Text Empty
Heading level H2, H3 H2
Columns on desktop 2, 3, 4 3
Image ratio Adapt to image, Square, Landscape, Portrait Square
Color scheme Color scheme Scheme 1
Section padding
Top padding 0–120 px, in steps of 4 48 px
Bottom padding 0–120 px, in steps of 4 48 px

You can add up to 12 blocks.

Image block.

Setting Options Default Notes
Image Image Empty
Alt text Text Empty Describe the image for people using screen readers. Leave empty for decorative images.
Caption Text Empty
Link Link Empty

Video

A hosted video, or a YouTube or Vimeo video that loads only when the visitor presses play.

Find it in the section picker under Media.

Setting Options Default Notes
Heading Text Empty
Heading level H2, H3 H2
Hosted video Video Empty Takes priority over the video URL when set.
Video URL YouTube or Vimeo URL "https://www.youtube.com/watch?v=_9VUPq3SxOc" YouTube or Vimeo. Loads only when the visitor presses play.
Cover image Image Empty Shown before an external video loads. Use a still from the video.
Description Text "Video showing how the product is used" Required. Describe what the video shows for people using screen readers.
Show description as a caption On or off Off
Width Medium, Wide Medium
Color scheme Color scheme Scheme 1
Section padding
Top padding 0–120 px, in steps of 4 48 px
Bottom padding 0–120 px, in steps of 4 48 px

Logo list

Up to 12 logos, such as stockists or memberships you hold.

Find it in the section picker under Trust and education.

Setting Options Default Notes
Heading Text "Available from"
Heading level H2, H3 H2
Logo height 24–96 px, in steps of 4 40 px
Show logos in grayscale On or off On Full color on hover and focus.
Color scheme Color scheme Scheme 1
Section padding
Top padding 0–120 px, in steps of 4 32 px
Bottom padding 0–120 px, in steps of 4 32 px

You can add up to 12 blocks.

Logo block.

Setting Options Default Notes
Image Image Empty
Link Link Empty
Alt text Text Empty Describe the image for people using screen readers. Leave empty for decorative images.

Testimonials

Customer quotes. Use only real quotes from customers who agreed to be quoted.

Find it in the section picker under Trust and education.

Use only real, verifiable testimonials from customers who agreed to be quoted. Disclose any incentive. Do not invent quotes or ratings.

Setting Options Default Notes
Heading Text "What customers say"
Heading level H2, H3 H2
Introduction Rich text Empty
Layout Grid, Row with arrows Grid
Columns on desktop 2–4, in steps of 1 3
Color scheme Color scheme Scheme 2
Section padding
Top padding 0–120 px, in steps of 4 48 px
Bottom padding 0–120 px, in steps of 4 48 px

You can add up to 12 blocks.

Testimonial block.

Setting Options Default Notes
Quote Rich text "Add a customer quote. Use the customer's own words and keep a copy of their permission."
Name Text "Customer name"
Detail Text Empty Optional context, for example a city or the product bought.
Rating 0–5, in steps of 1 0 Optional. Leave at 0 to hide stars. Only show a rating the customer actually gave.

Trust strip

Up to five short service promises with icons, such as returns or shipping.

Find it in the section picker under Trust and education.

Only publish service promises you honor, such as returns, shipping and support hours.

Setting Options Default Notes
Layout Inline, Grid Inline
Show divider On or off On
Color scheme Color scheme Scheme 1
Section padding
Top padding 0–120 px, in steps of 4 24 px
Bottom padding 0–120 px, in steps of 4 24 px

Accepts these blocks: Icon with text.

You can add up to 5 blocks.

Promo banner

A campaign banner with an image, heading, text and button. It has no timers or stock counters.

Find it in the section picker under Products.

Campaign banner without timers or stock counters.

Setting Options Default Notes
Image Image Empty
Heading Text "Stock up on everyday essentials"
Heading level H2, H3 H2
Text Rich text "Save on multipacks of the products you reorder most."
Button label Text "Shop multipacks"
Button link Link Empty
Layout Image with overlay, Split, image left, Split, image right Image with overlay
Overlay opacity 0–80%, in steps of 5 40%
Banner color scheme Color scheme Scheme 2 Used by the split layouts.
Color scheme Color scheme Scheme 1
Section padding
Top padding 0–120 px, in steps of 4 48 px
Bottom padding 0–120 px, in steps of 4 48 px

Blog posts

The latest articles from a blog.

Find it in the section picker under Content.

Setting Options Default Notes
Blog Blog Empty
Maximum items 2–6, in steps of 1 3
Columns on desktop 2–4, in steps of 1 3
Show publish date On or off On
Show "Reviewed by" line On or off On Appears when an article has a reviewer set in its health metafields.
Show "View all" link On or off On
Color scheme Color scheme Scheme 1
Section padding
Top padding 0–120 px, in steps of 4 48 px
Bottom padding 0–120 px, in steps of 4 48 px

Accepts these blocks: Heading, Text, Button.

Email signup

An email signup form with consent text and the privacy notice.

Find it in the section picker under Forms.

Setting Options Default Notes
Heading Text "Reorder reminders and product news"
Heading level H2, H3 H2
Text Rich text "Occasional emails about new products, restocks and how-to guides. No more than twice a month."
Button label Text "Sign up"
Consent text Rich text "By signing up you agree to receive marketing emails. Unsubscribe anytime."
Show privacy notice On or off On
Color scheme Color scheme Scheme 2
Section padding
Top padding 0–120 px, in steps of 4 48 px
Bottom padding 0–120 px, in steps of 4 48 px

FAQ

Questions and answers in expandable rows.

Find it in the section picker under Content.

Setting Options Default Notes
Heading Text "Frequently asked questions"
Heading level H2, H3 H2
Introduction Rich text Empty
Open the first question by default On or off Off
Add FAQ structured data On or off Off Outputs FAQPage JSON-LD. Google shows FAQ rich results only for authoritative government and health sites, so leave this off unless you qualify.
Color scheme Color scheme Scheme 1
Section padding
Top padding 0–120 px, in steps of 4 48 px
Bottom padding 0–120 px, in steps of 4 48 px

You can add up to 20 blocks.

Question block.

Setting Options Default Notes
Question Text "How long does shipping take?"
Answer Rich text "Add the answer here. Keep it short and link to a policy page for the details."

How to use

Up to eight steps with images or videos. It can link to your instructions for use.

Find it in the section picker under Health information.

Setting Options Default Notes
Heading Text "How to use"
Heading level H2, H3 H2
Introduction Rich text Empty
Layout Numbered list, Cards, Timeline Numbered list
Instructions for use link Link Empty Shown as "Always read the instructions for use." Link to the product's documents or a document library page.
Color scheme Color scheme Scheme 1
Section padding
Top padding 0–120 px, in steps of 4 48 px
Bottom padding 0–120 px, in steps of 4 48 px

You can add up to 8 blocks.

Step block.

Setting Options Default Notes
Image Image Empty
Video Video Empty Optional. A hosted video replaces the image for this step.
Heading Text "Wash your hands"
Text Rich text "Wash and dry your hands thoroughly before handling the product."

Evidence and references

Sources and references, each with a short summary and a link to the source.

Find it in the section picker under Trust and education.

Summarize each source accurately, link to the primary source and avoid overstating what it shows.

Setting Options Default Notes
Heading Text "The evidence"
Heading level H2, H3 H2
Introduction Rich text "Sources we used when writing about this product. Summaries are ours; follow the links for the full text."
Style List, Cards List
Open links in a new tab On or off Off
Color scheme Color scheme Scheme 1
Section padding
Top padding 0–120 px, in steps of 4 48 px
Bottom padding 0–120 px, in steps of 4 48 px

You can add up to 12 blocks.

Reference block.

Setting Options Default Notes
Title Text "Dressing wear time in home settings"
Source Text "Journal of Wound Care"
Year Text "2024"
URL Link Empty
Summary Rich text "Summarize what the source reports in one or two plain sentences, without adding conclusions of your own."

Reviewer panel

The professionals who review your content, with their credentials.

Find it in the section picker under Trust and education.

List the professionals who review your content. Say what they reviewed, not that they recommend products.

Setting Options Default Notes
Heading Text "Content reviewed by professionals"
Heading level H2, H3 H2
Introduction Rich text "Product information and guides on this store are reviewed for accuracy by the people below before they are published."
Layout Grid, List Grid
Show reviewer note On or off On Adds a line explaining that reviewers check accuracy and do not endorse products.
Color scheme Color scheme Scheme 1
Section padding
Top padding 0–120 px, in steps of 4 48 px
Bottom padding 0–120 px, in steps of 4 48 px

You can add up to 8 blocks.

Reviewer block.

Setting Options Default Notes
Image Image Empty
Name Text "Reviewer name"
Credentials Text "Registered nurse" Job title or qualification, for example "Registered nurse".
Short bio Rich text "Add one or two sentences about this reviewer's background and what they review for the store."
URL Link Empty Optional link to a professional profile or registration.

Expert help

Points shoppers to your support team for product questions.

Find it in the section picker under Trust and education.

Points shoppers to your support team for product questions. The privacy notice and emergency line from theme settings always show.

Setting Options Default Notes
Heading Text "Questions about a product?"
Heading level H2, H3 H2
Text Rich text "Our support team can help you compare sizes, check what's in stock and find the instructions for a product. For advice about your health, please speak to a healthcare professional."
Button label Text "Contact us"
Button link Link Empty
Phone number Text Empty
Support hours Multi-line text "Monday to Friday, 9 am to 5 pm"
Color scheme Color scheme Scheme 2
Section padding
Top padding 0–120 px, in steps of 4 48 px
Bottom padding 0–120 px, in steps of 4 48 px

Replenishment explainer

Explains how repeat deliveries work in your store. Edit the steps to match what your subscription app really does.

Find it in the section picker under Products.

Edit the steps to match what your subscription app really lets customers do. Do not promise skipping, pausing or reminders unless the app supports them.

Setting Options Default Notes
Heading Text "Never run out of the essentials"
Heading level H2, H3 H2
Introduction Rich text "Set up a repeat delivery for the products you use regularly and manage it from your account."
Button label Text Empty
Button link Link Empty
Color scheme Color scheme Scheme 2
Section padding
Top padding 0–120 px, in steps of 4 48 px
Bottom padding 0–120 px, in steps of 4 48 px

You can add up to 5 blocks.

Step block.

Setting Options Default Notes
Icon None, Calendar, Refresh, Mail, Truck, Box, Document, Clock, Check Calendar
Heading Text "Choose how often"
Text Rich text "Pick a delivery interval that suits how quickly you get through the product."

HSA/FSA explainer

Explains how shoppers can use an HSA or FSA in your store. See HSA and FSA display.

Find it in the section picker under Trust and education.

Shown only when HSA/FSA is enabled in theme settings. Keep the copy factual: eligibility is decided by each shopper's plan.

Setting Options Default Notes
Heading Text "Shopping with your HSA or FSA"
Heading level H2, H3 H2
Introduction Rich text "Many everyday health products can be paid for with a health savings account (HSA) or flexible spending account (FSA). Here is how it works in our store."
Collection Collection Empty Eligible products. The first four are shown with a link to the collection.
Show disclosure On or off On Uses the HSA/FSA disclosure from theme settings.
Color scheme Color scheme Scheme 1
Section padding
Top padding 0–120 px, in steps of 4 48 px
Bottom padding 0–120 px, in steps of 4 48 px

You can add up to 4 blocks.

Step block.

Setting Options Default Notes
Icon None, Check, Shield, Clipboard, Document, Care, Box, Info, Lock Check
Heading Text "Check your plan"
Text Rich text "Your plan administrator can confirm what your account covers."

Custom Liquid

Add app snippets or your own Liquid code. Available on every template.

Find it in the section picker under Layout.

Setting Options Default Notes
Liquid code Liquid code Empty Add app snippets or other code to create advanced customizations.
Color scheme Color scheme Scheme 1
Section padding
Top padding 0–120 px, in steps of 4 48 px
Bottom padding 0–120 px, in steps of 4 48 px

Apps

A container for app blocks from installed apps.

Find it in the section picker under Layout.

Add blocks from installed apps. This section has no content of its own.

Setting Options Default Notes
Color scheme Color scheme Scheme 1
Section padding
Top padding 0–120 px, in steps of 4 48 px
Bottom padding 0–120 px, in steps of 4 48 px

Accepts these blocks: App blocks.

Product page

The Product information section holds the product page. Its blocks are listed after the section. Product blocks read the product they sit in, so you rarely need to set their Product setting.

Product information

The main product section. Add, remove and reorder its blocks. Two safety rules are built in: a product safety notice always shows (at the top, or where you place the Safety notice block), and safety information still shows after the buy buttons (or after the price) if you remove the Safety information block.

Setting Options Default Notes
Media
Media column width 50%, 58%, 66% 58%
Media layout Thumbnails below, Thumbnails left, Two-column grid, Stacked Thumbnails below
Enable image zoom On or off On
Loop videos On or off Off
Hide other variants' media On or off Off Shows only media assigned to the selected variant plus unassigned media.
Product information
Keep product information visible while scrolling on desktop On or off On
Show health data setup checker in the editor On or off On Visible only to you in the theme editor. Lists which health metafields have values.
Color scheme Color scheme Scheme 1
Section padding
Top padding 0–120 px, in steps of 4 32 px
Bottom padding 0–120 px, in steps of 4 64 px

Product recommendations

Related products from Shopify's recommendations. You can adjust them in the Search & Discovery app.

Find it in the section picker under Products.

Dynamic recommendations from Shopify. Customize them in the Search & Discovery app.

Setting Options Default Notes
Heading Text "You may also like"
Heading level H2, H3 H2
Maximum items 2–8, in steps of 1 4
Columns on desktop 2–5, in steps of 1 4
Color scheme Color scheme Scheme 1
Section padding
Top padding 0–120 px, in steps of 4 48 px
Bottom padding 0–120 px, in steps of 4 48 px

Product blocks

These blocks work in the Product information section. The Featured product section accepts Product title, Regulatory status, Price, Variant picker, Purchase options, Quantity, Buy buttons, HSA/FSA badge and Safety information. The quick add window uses Variant picker, Purchase options, Quantity and Buy buttons. Every product block has a Product setting; leave it empty to use the product the block sits in.

Safety notice

Shows the product's safety notice as a warning callout. Without this block, the notice is pinned to the top of the product information.

Shows the product's "safety_notice" health metafield. Without this block the notice is pinned to the top of the product information.

Setting Options Default Notes
Product Product The product this block sits in Leave empty to use the product this block sits in.
Custom value Rich text Empty Optional. Connect a metafield with the dynamic source icon, or leave empty to use the conventional health metafield.
Notice link (custom value) Link Empty
Block spacing 0–32 px, in steps of 4 0 px

Product title

The full product title.

Setting Options Default Notes
Product Product The product this block sits in Leave empty to use the product this block sits in.
Heading level H1, H2, H3 H1
Heading size Large, Medium, Small Medium
Show vendor On or off Off
Block spacing 0–32 px, in steps of 4 0 px

Regulatory status

Regulatory status chips or statements. See Regulatory status reference.

Prints the exact wording for each status in the "regulatory_status" health metafield. See the regulatory status reference in the documentation.

Setting Options Default Notes
Product Product The product this block sits in Leave empty to use the product this block sits in.
Style Chips, Statements, Chips and statements Chips
Maximum items 1–6, in steps of 1 3
Custom statuses Text Empty Comma-separated status codes, for example "us_510k_cleared, eu_ce_mdr". Overrides the metafield.
Block spacing 0–32 px, in steps of 4 0 px

Price

Price, compare-at price, unit price, tax note, Shop Pay Installments and an estimated price per unit. For dietary supplements it can also show the dietary supplement statement.

Setting Options Default Notes
Product Product The product this block sits in Leave empty to use the product this block sits in.
Show unit price On or off On
Show tax and shipping note On or off On
Show Shop Pay Installments On or off On Shows only when Shop Pay Installments is enabled for your store.
Show estimated price per unit On or off On Uses the units per pack health metafield when no unit price is set.
Block spacing 0–32 px, in steps of 4 0 px

HSA/FSA badge

The HSA/FSA eligible badge, with the disclosure on tap.

Shows only on products tagged as eligible. Settings under HSA and FSA in theme settings.

Setting Options Default Notes
Product Product The product this block sits in Leave empty to use the product this block sits in.
Show disclosure on tap On or off On
Block spacing 0–32 px, in steps of 4 0 px

Highlights

Up to four short highlight lines that you write. The theme adds icons only.

Shows up to four short lines written by you in the "benefits" health metafield. The theme never adds wording of its own.

Setting Options Default Notes
Product Product The product this block sits in Leave empty to use the product this block sits in.
Icon Check, Shield, Leaf, Droplet, Care Check
Custom value Multi-line text Empty One line per row. Overrides the metafield.
Block spacing 0–32 px, in steps of 4 0 px

Variant picker

Buttons, swatches or a dropdown for product options.

Setting Options Default Notes
Product Product The product this block sits in Leave empty to use the product this block sits in.
Style Buttons, Swatches, Dropdown Swatches Swatches show for options that have swatch colors or images; other options fall back to buttons.
Swatch shape Circle, Square Circle
Block spacing 0–32 px, in steps of 4 0 px

Purchase options

One-time purchase and subscription options. Shows only when a subscription app has created selling plans for the product.

Shows when a subscription app has created selling plans for the product.

Setting Options Default Notes
Product Product The product this block sits in Leave empty to use the product this block sits in.
Preselect the first subscription option On or off Off Off by default so shoppers actively choose a subscription.
Show savings On or off On
Block spacing 0–32 px, in steps of 4 0 px

Quantity

A quantity selector with quantity rules and volume pricing.

Setting Options Default Notes
Product Product The product this block sits in Leave empty to use the product this block sits in.
Show quantity rules On or off On
Show volume pricing On or off On
Block spacing 0–32 px, in steps of 4 0 px

Buy buttons

Add to cart, the dynamic checkout button, the gift card recipient form and pickup availability.

Setting Options Default Notes
Product Product The product this block sits in Leave empty to use the product this block sits in.
Show dynamic checkout button On or off On Each customer sees their preferred payment method, such as Shop Pay or PayPal.
Show recipient form for gift cards On or off On
Show pickup availability On or off On
Block spacing 0–32 px, in steps of 4 8 px

Supply planner

Estimates how long an order lasts. See Supply planner.

Shows when the product has the "units_per_pack" health metafield. Estimates how long an order lasts and, if selling plans exist, suggests a delivery interval.

Setting Options Default Notes
Product Product The product this block sits in Leave empty to use the product this block sits in.
Heading Text "Plan your supply"
Question Text "How many {units} do you use each week?" Use {units} where the plural unit name should appear.
Suggest a delivery interval On or off On Matches selling plan names that include a period, such as "Every 2 weeks".
Block spacing 0–32 px, in steps of 4 4 px

Safety information

The "Important safety information" band: contraindications, warnings, precautions and possible side effects.

If you remove this block, the theme still shows safety information after the buy buttons when a product has any.

Setting Options Default Notes
Product Product The product this block sits in Leave empty to use the product this block sits in.
Heading Text "Important safety information"
Contraindications On or off On
Warnings On or off On
Precautions On or off On
Possible side effects On or off On
Open by default On or off On
Custom values
Contraindications Rich text Empty Optional. Connect a metafield with the dynamic source icon, or leave empty to use the conventional health metafield.
Warnings Rich text Empty Optional. Connect a metafield with the dynamic source icon, or leave empty to use the conventional health metafield.
Precautions Rich text Empty Optional. Connect a metafield with the dynamic source icon, or leave empty to use the conventional health metafield.
Possible side effects Rich text Empty Optional. Connect a metafield with the dynamic source icon, or leave empty to use the conventional health metafield.
Block spacing 0–32 px, in steps of 4 4 px

Intended use

The intended use and, optionally, indications.

Setting Options Default Notes
Product Product The product this block sits in Leave empty to use the product this block sits in.
Heading Text "Intended use"
Show indications On or off On
Intended use (custom value) Rich text Empty Optional. Connect a metafield with the dynamic source icon, or leave empty to use the conventional health metafield.
Indications (custom value) Rich text Empty Optional. Connect a metafield with the dynamic source icon, or leave empty to use the conventional health metafield.
Block spacing 0–32 px, in steps of 4 0 px

Size and features

Pad size, overall size, exudate level and wear time, plus latex-free, waterproof and sterile ticks.

Setting Options Default Notes
Product Product The product this block sits in Leave empty to use the product this block sits in.
Heading Text "Size and features"
Show feature ticks (latex-free, waterproof, sterile) On or off On
Block spacing 0–32 px, in steps of 4 0 px

Specifications

A specifications table from the specs JSON metafield.

Table from the "specs" health metafield (JSON). Also used for product comparison.

Setting Options Default Notes
Product Product The product this block sits in Leave empty to use the product this block sits in.
Heading Text "Specifications"
Collapsed by default On or off Off
Block spacing 0–32 px, in steps of 4 0 px

Documents

Instructions for use and other documents, grouped by type, with previous versions.

Lists documents from the "documents" health metafield (metaobjects) or the "document_files" file list.

Setting Options Default Notes
Product Product The product this block sits in Leave empty to use the product this block sits in.
Heading Text "Documents and instructions"
Show previous versions On or off On
Show shopper's language first On or off Off Documents in the shopper's language are listed before other languages.
Block spacing 0–32 px, in steps of 4 8 px

How to use

Numbered steps from the how_to_use metafield, with optional images.

Numbered steps from the "how_to_use" health metafield, with optional matching images.

Setting Options Default Notes
Product Product The product this block sits in Leave empty to use the product this block sits in.
Heading Text "How to use"
Layout List, Cards List
Block spacing 0–32 px, in steps of 4 8 px

What's inside

Ingredients, allergens, age suitability and a Supplement Facts or Drug Facts label image.

Setting Options Default Notes
Product Product The product this block sits in Leave empty to use the product this block sits in.
Heading Text "What's inside"
Show label image On or off On Supplement Facts or Drug Facts image from health metafields. Add a full transcription in the file's alt text.
Custom value Rich text Empty Optional. Connect a metafield with the dynamic source icon, or leave empty to use the conventional health metafield.
Block spacing 0–32 px, in steps of 4 8 px

Description

The product description.

Setting Options Default Notes
Product Product The product this block sits in Leave empty to use the product this block sits in.
Show in a collapsible row On or off Off
Block spacing 0–32 px, in steps of 4 8 px

Product identifiers

SKU, barcode or GTIN, UDI-DI and model number.

Setting Options Default Notes
Product Product The product this block sits in Leave empty to use the product this block sits in.
Show SKU On or off On
Show barcode or GTIN On or off On
Show UDI-DI On or off On
Show model number On or off On
Block spacing 0–32 px, in steps of 4 0 px

Responsible persons

Manufacturer, EU and UK responsible persons and importer.

Setting Options Default Notes
Product Product The product this block sits in Leave empty to use the product this block sits in.
Heading Text "Manufacturer and responsible persons"
Collapsed by default On or off On
Block spacing 0–32 px, in steps of 4 0 px

Content reviewed by

Who reviewed the content and when.

Reads the "reviewed_by" and "last_reviewed" health metafields. The label is always "reviewed", never "recommended".

Setting Options Default Notes
Product Product The product this block sits in Leave empty to use the product this block sits in.
Show photo On or off On
Show last reviewed date On or off On
Block spacing 0–32 px, in steps of 4 0 px

References

A list of references.

Setting Options Default Notes
Product Product The product this block sits in Leave empty to use the product this block sits in.
Heading Text "References"
Custom value Rich text Empty Optional. Connect a metafield with the dynamic source icon, or leave empty to use the conventional health metafield.
Open by default On or off Off
Block spacing 0–32 px, in steps of 4 0 px

Disclaimer

Small print. With no text, it shows the dietary supplement statement for products with the dietary supplement status.

Setting Options Default Notes
Product Product The product this block sits in Leave empty to use the product this block sits in.
Text Rich text Empty Leave empty to show the dietary supplement statement automatically for supplements.
Block spacing 0–32 px, in steps of 4 0 px

Collapsible row

An expandable row with your own text or the content of a page.

Setting Options Default Notes
Heading Text "Shipping and returns"
Icon None, Truck, Box, Refresh, Shield, Info, Document, Clock None
Text Rich text "Describe your shipping times and returns process. Only publish promises you honor."
Content from page Page Empty Replaces the text above when set.
Open by default On or off Off
Block spacing 0–32 px, in steps of 4 0 px

Inventory status

Real stock status from your inventory, with an optional low stock count.

Setting Options Default Notes
Product Product The product this block sits in Leave empty to use the product this block sits in.
Low stock threshold 0–50, in steps of 1 5 Shows the real remaining quantity when inventory is tracked and at or below this number. Set to 0 to never show a count.
Show "In stock" On or off On
Block spacing 0–32 px, in steps of 4 0 px

Complementary products

Complementary products you set in the Search & Discovery app.

Set complementary products in the Search & Discovery app. Hidden when none are set.

Setting Options Default Notes
Product Product The product this block sits in Leave empty to use the product this block sits in.
Heading Text "Use it with"
Maximum items 2–6, in steps of 1 4
Layout List, Cards List
Show quick add buttons On or off On
Block spacing 0–32 px, in steps of 4 8 px

Share

A share button.

Setting Options Default Notes
Product Product The product this block sits in Leave empty to use the product this block sits in.
Label Text "Share"
Block spacing 0–32 px, in steps of 4 0 px

The Product information section also accepts App blocks, Custom Liquid, Group, Heading, Text, Button, Image and Icon with text.

Collection and search

These sections run the collection, collection list and search result pages.

Product grid

The collection page: banner, filters, sorting and the product grid. Add Promotion tile blocks to place a tile inside the grid.

Setting Options Default Notes
Show collection description and image On or off On
Banner style Text only, Image beside text, Image with overlay Text only
Products per page 8–48, in steps of 4 24
Columns on desktop 2–5, in steps of 1 4
Columns on mobile 1, 2 2
Filtering and sorting
Enable filtering On or off On Customize filters in the Search & Discovery app.
Enable sorting On or off On
Desktop filter layout Sidebar, Horizontal bar, Drawer Sidebar
Pin HSA/FSA eligible filter On or off On Shows a one-tap toggle when a tag filter matching your HSA/FSA tag exists.
Pagination Numbered pages, Load more button Numbered pages
Color scheme Color scheme Scheme 1
Section padding
Top padding 0–120 px, in steps of 4 32 px
Bottom padding 0–120 px, in steps of 4 64 px

Promotion tile block.

Setting Options Default Notes
Image Image Empty
Heading Text "Build your first aid kit"
Text Text Empty
Link Link Empty
Position in grid 1–24, in steps of 1 4
Span two columns On or off Off
Color scheme Color scheme Scheme 2

Collections list

The page that lists all collections.

Setting Options Default Notes
Collections per page 8–36, in steps of 4 24
Columns on desktop 2–5, in steps of 1 3
Image ratio Square, Landscape, Portrait Landscape
Show product count On or off On
Color scheme Color scheme Scheme 1
Section padding
Top padding 0–120 px, in steps of 4 32 px
Bottom padding 0–120 px, in steps of 4 64 px

Search results

The search results page, with filters and sorting.

Setting Options Default Notes
Results per page 8–48, in steps of 4 24
Enable filtering On or off On
Enable sorting On or off On
Collections to suggest when nothing is found Collections Empty Shown on the no-results message.
Color scheme Color scheme Scheme 1
Section padding
Top padding 0–120 px, in steps of 4 32 px
Bottom padding 0–120 px, in steps of 4 64 px

Cart

Most cart options are in theme settings under Cart. The cart drawer has no section settings of its own.

Cart

The cart page.

Setting Options Default Notes
Color scheme Color scheme Scheme 1
Section padding
Top padding 0–120 px, in steps of 4 32 px
Bottom padding 0–120 px, in steps of 4 64 px

Pages, blog and other templates

These sections run pages, the blog and utility templates.

Page

The page title and content.

Setting Options Default Notes
Width Narrow, Medium, Wide Narrow
Show reviewer line On or off On Reads the page's "reviewed_by" and "last_reviewed" health metafields.
Color scheme Color scheme Scheme 1
Section padding
Top padding 0–120 px, in steps of 4 48 px
Bottom padding 0–120 px, in steps of 4 48 px

Contact form

A contact form with name, email and message, plus optional phone and order number fields. It has no file upload or health fields by design.

Find it in the section picker under Forms.

Messages are sent to your store's sender email. The form has no file upload or health fields by design.

Setting Options Default Notes
Heading Text "Contact us"
Heading level H2, H3 H2
Text Rich text "Questions about an order, a product or its documents? Send us a message and we'll reply by email."
Show phone number field On or off Off
Show order number field On or off On
Button label Text "Send message"
Privacy notice Rich text Empty Leave empty to use the privacy notice from theme settings.
Color scheme Color scheme Scheme 1
Section padding
Top padding 0–120 px, in steps of 4 48 px
Bottom padding 0–120 px, in steps of 4 48 px

Document library

A store-wide page of instructions and documents. See Documents and safety notices.

Find it in the section picker under Health information.

Lists products alphabetically with their current documents. Products without documents are skipped. Superseded versions are not shown here; they remain on each product page.

Setting Options Default Notes
Heading Text Empty Leave empty to use "Instructions and documents".
Heading level H2, H3 H2
Introduction Rich text "Current instructions for use and other documents for the products we carry. Always read the instructions supplied with your product."
Collection Collection Empty Leave empty to include all products.
Products per page 12–48, in steps of 4 24
Show search by product name On or off On
Show document type filter On or off On
Color scheme Color scheme Scheme 1
Section padding
Top padding 0–120 px, in steps of 4 48 px
Bottom padding 0–120 px, in steps of 4 48 px

Safety notices list

A page of recalls and field safety notices. See Documents and safety notices.

Find it in the section picker under Health information.

Products in the chosen collection show their own safety notice. Add notice blocks for discontinued products or notices without a product page, newest first.

Setting Options Default Notes
Heading Text "Safety notices"
Heading level H2, H3 H2
Introduction Rich text "Recalls and field safety notices for products we sell or have sold. If you own an affected product, follow the instructions in the notice and contact us with any questions."
Collection Collection Empty A collection you maintain, for example "Safety notices", containing every product with an active notice.
Color scheme Color scheme Scheme 1
Section padding
Top padding 0–120 px, in steps of 4 48 px
Bottom padding 0–120 px, in steps of 4 48 px

You can add up to 20 blocks.

Notice block.

Setting Options Default Notes
Date Text Empty Written out, for example "12 March 2026".
Title Text Empty
Affected products Text Empty Product names, models or lot numbers.
Summary Rich text Empty
Link Link Empty Link to the full notice, for example a PDF or the manufacturer's page.

Blog posts

The blog page with a grid of articles.

Setting Options Default Notes
Posts per page 6–24, in steps of 3 12
Columns on desktop 2–4, in steps of 1 3
Show date On or off On
Show excerpt On or off On
Show reviewer On or off On Shows "Reviewed by" when an article has a reviewer health metafield.
Color scheme Color scheme Scheme 1
Section padding
Top padding 0–120 px, in steps of 4 32 px
Bottom padding 0–120 px, in steps of 4 64 px

Blog post

A blog article. Its blocks are the title, date and author, featured image, content, references, share and comments.

Setting Options Default Notes
Color scheme Color scheme Scheme 1
Section padding
Top padding 0–120 px, in steps of 4 32 px
Bottom padding 0–120 px, in steps of 4 64 px

Title block. You can add one of these.

This block has no settings.

Date and author block. You can add one of these.

Setting Options Default Notes
Show author On or off On
Show reviewer On or off On Reads the article's "reviewed_by" and "last_reviewed" health metafields.

Featured image block. You can add one of these.

This block has no settings.

Content block. You can add one of these.

This block has no settings.

References block. You can add one of these.

This block has no settings.

Share block. You can add one of these.

This block has no settings.

Comments block. You can add one of these.

This block has no settings.

404 page

The page shown when a link is broken.

Setting Options Default Notes
Popular collections Collections Empty
Color scheme Color scheme Scheme 1
Section padding
Top padding 0–120 px, in steps of 4 64 px
Bottom padding 0–120 px, in steps of 4 96 px

Password page

The page shown while your store is password protected.

Setting Options Default Notes
Show email signup On or off On
Consent text Rich text "We'll email you when the store opens. Unsubscribe anytime."
Color scheme Color scheme Scheme 1

General theme blocks

Many sections accept these blocks. In the editor they are listed by name when you select Add block.

Heading

A heading with a level and size you choose.

Setting Options Default Notes
Heading Text "Heading"
Heading level H1, H2, H3, H4, Paragraph (no heading) H2 Use H1 only when this is the first section on a page without another H1.
Heading size Extra large, Large, Medium, Small, Eyebrow Medium
Content alignment Left, Center, Right Left
Block spacing 0–32 px, in steps of 4 0 px

Text

A paragraph of rich text.

Setting Options Default Notes
Text Rich text "Add a short paragraph that explains this section. Keep it factual and specific."
Text size Small, Medium, Large Medium
Width Narrow, Medium, Wide Medium
Content alignment Left, Center, Right Left
Block spacing 0–32 px, in steps of 4 0 px

Button

A button or text link.

Setting Options Default Notes
Button label Text "Shop now"
Button link Link Empty
Button style Primary, Secondary, Text link Primary
Content alignment Left, Center, Right Left
Full width On or off Off
Open link in a new tab On or off Off
Block spacing 0–32 px, in steps of 4 8 px

Image

An image with alt text, an optional link and a caption.

Setting Options Default Notes
Image Image Empty
Alt text Text Empty Describe the image for people using screen readers. Leave empty for decorative images.
Image ratio Adapt to image, Square, Portrait, Landscape, Wide (16:9) Adapt to image
Width Wide, One half, One third Wide
Content alignment Left, Center, Right Left
Link Link Empty
Caption Text Empty
Block spacing 0–32 px, in steps of 4 0 px

Icon with text

An icon with a heading and text.

Setting Options Default Notes
Icon None, Check, Shield, Truck, Box, Refresh, Calendar, Clipboard, Care, Thermometer, Heart rate, Bandage, Capsule, Leaf, Droplet, Document, Globe, Lock, Phone, Mail, Info, Clock, Map pin, Store Check
Icon style Plain, Circle Plain
Heading Text "Ships in plain packaging"
Heading level H3, H4, Paragraph (no heading) H3
Text Rich text "Orders are packed discreetly with no product names on the outer box."
Layout Inline, Stacked Inline
Content alignment Left, Center Left
Block spacing 0–32 px, in steps of 4 0 px

Group

Holds other blocks in a row or column. Its presets are named Column and Row.

Setting Options Default Notes
Layout Column, Row Column
Content alignment Left, Center, Right Left
Space between items 0–48 px, in steps of 4 16 px
Inner padding 0–48 px, in steps of 4 0 px
Show as card On or off Off
Color scheme Color scheme Empty

Accepts: Any theme block, App blocks.

Spacer

Adds vertical space.

Setting Options Default Notes
Size 4–96 px, in steps of 4 24 px

Custom Liquid

Add app snippets or your own Liquid code.

Setting Options Default Notes
Liquid code Liquid code Empty Add app snippets or other code to create advanced customizations.

Sections that work in the background

Some sections have no settings. The theme uses them to update parts of the page without a full reload: the cart drawer, cart icon, compare tray, comparison data, pickup availability, predictive search and quick add. You don't need to add or edit them.