Blocks
Blocks are the pieces you add, remove and reorder inside a section. Which blocks a section accepts is listed on that section in Sections.
| Block | Added by you | Settings |
|---|---|---|
| Buy buttons | Yes | 2 |
| Collapsible row | Yes | 4 |
| Collection card | No — part of a fixed layout | 4 |
| Custom Liquid | Yes | 3 |
| Delivery estimate | Yes | 13 |
| Dispatch cutoff | Yes | 2 |
| FAQ item | Yes | 3 |
| Logo | Yes | 3 |
| Menu | Yes | 2 |
| Newsletter | Yes | 4 |
| Text | Yes | 2 |
| Often bought with | Yes | 3 |
| Gift card recipient | Yes | 0 |
| Group | Yes | 3 |
| Hotspot | Yes | 6 |
| Logo | Yes | 2 |
| Low stock | Yes | 3 |
| Message | No — part of a fixed layout | 2 |
| Pickup availability | Yes | 0 |
| Description | Yes | 1 |
| Price | Yes | 4 |
| Reviews | Yes | 2 |
| Separator | Yes | 1 |
| Share | Yes | 1 |
| Text | Yes | 3 |
| Product title | Yes | 2 |
| Promo bar | No — part of a fixed layout | 1 |
| Promo block | Yes | 6 |
| Quantity selector | Yes | 1 |
| Review | No — part of a fixed layout | 5 |
| Purchase options | No — part of a fixed layout | 0 |
| Size chart | Yes | 4 |
| Slide | Yes | 14 |
| Text | Yes | 3 |
| Timeline step | Yes | 3 |
| Trust badges | Yes | 4 |
| Trust item | Yes | 2 |
| Variant picker | Yes | 1 |
| Volume pricing | Yes | 1 |
buy-buttons
Buy buttons
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Show quantity selector | show_quantity | checkbox | true | — |
| Reassurance text | reassurance | text | Free shipping · 30-day returns | Risk-reversal micro-copy shown under the Add to cart button |
collapsible-tab
Collapsible row
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Heading | heading | text | Shipping & returns | — |
| Content | content | richtext | <p>Add shipping and returns details here.</p> | — |
| Icon | icon | select | none | Options: None, Truck, Return, Shield, Leaf, Headset |
| Open by default | open_by_default | checkbox | false | — |
collection-card
Collection card
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Collection | collection | collection | — | — |
| Title | title | text | — | Leave blank to use the collection title |
| Show product count | show_count | checkbox | true | — |
| Focal point | focal_point | select | center center | Which part of the image stays in frame when it is cropped. Options: Top left, Top center, Top right, Center left, Center, Center right, Bottom left, Bottom center, Bottom right |
custom-liquid
Custom Liquid
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Liquid code | custom_liquid | liquid | — | Add app snippets or other Liquid code to create advanced customizations |
Spacing
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Top padding | padding_top | range | 0 | 0–100 px, step 4 |
| Bottom padding | padding_bottom | range | 0 | 0–100 px, step 4 |
delivery-date
Delivery estimate
Weekends and holidays (shared by both tiers) are set in Theme settings → Delivery estimate.
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Heading | heading | text | — | — |
| Show order-by countdown | show_countdown | checkbox | true | — |
Standard delivery
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Label | standard_label | text | Standard delivery | — |
| Order-by cutoff hour | standard_cutoff_hour | range | 15 | 0–23 h, step 1 |
| Processing time | standard_processing_days | range | 1 | 0–10 d, step 1 |
| Transit time (fastest) | standard_transit_min | range | 2 | 0–30 d, step 1 |
| Transit time (slowest) | standard_transit_max | range | 4 | 0–60 d, step 1 |
Express delivery
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Show express tier | express_enabled | checkbox | false | — |
| Label | express_label | text | Express delivery | — |
| Order-by cutoff hour | express_cutoff_hour | range | 15 | 0–23 h, step 1 |
| Processing time | express_processing_days | range | 0 | 0–10 d, step 1 |
| Transit time (fastest) | express_transit_min | range | 1 | 0–30 d, step 1 |
| Transit time (slowest) | express_transit_max | range | 2 | 0–60 d, step 1 |
dispatch-cutoff
Dispatch cutoff
Counts down to your daily dispatch cutoff, then states the next working day. Only shown on products that are in stock, so it never promises same-day dispatch for something you can’t send.
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Cutoff time | cutoff_time | text | 14:00 | 24-hour, in your store’s timezone. For example 14:00 |
| Dispatch days | dispatch_days | select | weekdays | Options: Monday to Friday, Monday to Saturday, Every day |
faq-item
FAQ item
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Question | question | text | Frequently asked question | — |
| Answer | answer | richtext | <p>Add the answer to this question here.</p> | — |
| Open by default | open_by_default | checkbox | false | — |
footer-logo
Logo
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Logo image | logo | image_picker | — | Falls back to the theme logo when empty |
| Logo height | logo_height | range | 44 | 20–80 px, step 2 |
| Tagline | tagline | richtext | <p>A short line about your brand.</p> | — |
footer-menu
Menu
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Heading | heading | text | Quick links | — |
| Menu | menu | link_list | main-menu | — |
footer-newsletter
Newsletter
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Heading | heading | text | Newsletter | — |
| Text | text | richtext | <p>Subscribe for updates and offers.</p> | — |
| Placeholder | placeholder | text | Email address | — |
| Button label | button_label | text | Subscribe | — |
footer-text
Text
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Heading | heading | text | About us | — |
| Text | text | richtext | <p>Tell customers a little about your store.</p> | — |
frequently-bought-together
Often bought with
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Heading | heading | text | Often bought with | — |
| Products metafield | metafield | text | custom.frequently_bought_together | A product-list metafield holding the recommended products, e.g. custom.frequently_bought_together |
| Show “Add all to cart” | show_add_all | checkbox | true | — |
gift-card-recipient
Gift card recipient
Lets shoppers send a gift card directly to someone else. Only appears on gift card products.
group
Group
- Accepts blocks:
@theme(any theme block)
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Layout direction | layout_direction | select | group--vertical | Options: Horizontal, Vertical |
| Alignment | alignment | select | flex-start | Options: Left, Center, Right. Shown when layout_direction == 'group--vertical' |
| Padding | padding | range | 0 | 0–200 px, step 2 |
hotspot
Hotspot
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Product | product | product | — | — |
| Number label | number_label | text | — | Optional — shows a small number inside the dot instead of a plain marker |
Position (desktop)
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Horizontal | position_x | range | 50 | 0–100 %, step 1 |
| Vertical | position_y | range | 50 | 0–100 %, step 1 |
Position (mobile)
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Horizontal | position_x_mobile | range | 50 | 0–100 %, step 1 |
| Vertical | position_y_mobile | range | 50 | 0–100 %, step 1 |
logo
Logo
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Image | image | image_picker | — | — |
| Button link | link | url | — | — |
low-stock
Low stock
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Show when stock at or below | threshold | range | 10 | 1–50, step 1 |
| Critical level | critical_threshold | range | 3 | At or below this quantity the indicator turns red. Set to 0 to disable. 0–20, step 1 |
| Show icon | show_icon | checkbox | true | — |
message
Message
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Text | text | text | Free shipping on orders over $50 | — |
| Link (optional) | link | url | — | — |
pickup-availability
Pickup availability
Shows which of your locations have this item ready for local pickup. Set up pickup in Settings > Shipping and delivery. Nothing is shown if no location offers pickup.
product-description
Description
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Heading | heading | text | — | — |
product-price
Price
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Show compare-at price | show_compare_price | checkbox | true | — |
| Show sale badge | show_sale_badge | checkbox | true | — |
| Sale badge shows | sale_badge_content | select | percent | Options: Sale, Percentage off (−30%), Amount saved (Save $12). Shown when show_sale_badge |
| Show unit price | show_unit_price | checkbox | true | — |
product-reviews
Reviews
- Accepts blocks:
@app(blocks from installed apps)
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Heading | heading | text | Reviews | — |
| App embed code | custom_embed | html | — | Optional: paste a review app’s HTML/Liquid embed. Or add the app’s block inside this one |
product-separator
Separator
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Spacing | spacing | range | 8 | 0–40 px, step 2 |
product-share
Share
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Heading | heading | text | Share | — |
product-text
Text
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Text | text | richtext | <p>Add a sales point or note here.</p> | — |
| Text size | text_size | select | 1rem | Options: Small, Medium, Large |
| Alignment | alignment | text_alignment | left | — |
product-title
Product title
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Heading size | heading_size | select | m | Options: Small, Medium, Large |
| Show vendor | show_vendor | checkbox | false | — |
promo-bar
Promo bar
- Accepts blocks: promo-block
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Bar label | bar_label | text | Extra 20% off | — |
promo-block
Promo block
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Heading | title | text | Special offer | — |
| Subtext | subtext | text | Save an extra 10% | — |
| Promo code | promo_code | text | — | — |
| “Shop” button label | shop_label | text | Shop now | — |
| “Shop” button link | shop_url | url | — | — |
| Supporting text | supporting_text | text | — | e.g. “Online exclusive” or “Free delivery on orders $500+” |
quantity-selector
Quantity selector
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Show label | show_label | checkbox | true | — |
review
Review
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Star rating | rating | range | 5 | 0–5, step 1 |
| Specimen reference | title | text | V-001 | Shown in the card footer, e.g. V-084 |
| Text | description | richtext | <p>Add a short customer quote here.</p> | — |
| Author | author | text | Marcus K. [Berlin] | — |
| Author label | author_prefix | text | Verified collector | Shown before the name, e.g. “Verified collector”. Leave blank to show the name on its own |
selling-plans
Purchase options
No settings.
size-chart
Size chart
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Link text | link_text | text | Size chart | — |
| Heading | heading | text | Size chart | — |
| Image | image | image_picker | — | Falls back to the store-wide size chart image (Theme settings → Product) |
| Content | content | richtext | — | Optional. Connect a product metafield here to show a per-product chart |
slide
Slide
Image
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Desktop image | image | image_picker | — | — |
| Mobile image | image_mobile | image_picker | — | Falls back to the desktop image when not set |
| Image overlay | overlay_opacity | range | 20 | 0–100 %, step 5 |
Content
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Subheading | subheading | text | — | — |
| Heading | heading | text | — | — |
| Description | description | richtext | — | — |
| Content position | content_position | select | center | Options: Center, Bottom center |
| Add background | content_background_enabled | checkbox | false | — |
| Background | content_background_color | color | rgba(0, 0, 0, 0.35) | Shown when content_background_enabled |
Button
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Button label | button_label | text | — | — |
| Button link | button_link | url | — | — |
| Button style | button_style | select | solid | Options: Solid, Outline (no background), No button |
| Background | button_bg_color | color | #1A1A1A | — |
| Foreground | button_text_color | color | #FFFFFF | — |
text
Text
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Text | text | text | Text | — |
| Text style | text_style | select | text--title | Options: Title, Subtitle, Normal text |
| Alignment | alignment | text_alignment | left | — |
timeline-step
Timeline step
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Step label | label | text | — | Leave blank to number the steps automatically (01, 02, 03 …) |
| Title | title | text | Fibre selection | — |
| Text | text | richtext | <p>Describe this stage of the process.</p> | — |
trust-badges
Trust badges
- Accepts blocks: trust-item
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Heading | heading | text | — | — |
| Layout | layout | select | row | Options: Row, Stack |
| Alignment | alignment | select | flex-start | Options: Left, Center, Right |
| Icon size | icon_size | range | 26 | 16–48 px, step 2 |
trust-item
Trust item
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Icon | icon | select | truck | Options: Shield, Truck, Lock, Return, Leaf, Star, Gift, Check, Headset, Credit card, Badge, Heart |
| Text | text | text | Free shipping over $50 | — |
variant-picker
Variant picker
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Colour option name | swatch_option_name | text | Color-Colour-color-colour | Separate several accepted names with hyphens, e.g. Color-Colour |
volume-pricing
Volume pricing
| Setting | ID | Type | Default | Notes |
|---|---|---|---|---|
| Show heading | show_heading | checkbox | true | — |