Sections and blocks reference
Every section and block with its settings. Sections marked addable can be added to any page; the others belong to a specific page type.
Announcement baraddable3 block types
| Setting | Type | Details |
|---|---|---|
| Color scheme | color scheme |
Default: scheme-4
|
| Rotate messages automatically | checkbox |
Starts once the shopper scrolls or interacts with the page, pauses on hover and focus and when off screen, and stays off for visitors who prefer reduced motion.
Default: on
|
| Change message every | range |
Range: 3–12s
Default: 5
|
Block: Message
| Setting | Type | Details |
|---|---|---|
| Text | inline richtext |
Default: Free shipping on orders over $99
|
| Link | url | |
| Link label | text | Optional. Shown after the text. |
Block: Countdown
| Setting | Type | Details |
|---|---|---|
| Text | text |
Default: Sale ends in
|
| End date | text | YYYY-MM-DD. The countdown hides itself once this time has passed. |
| End time (store time) | text |
24-hour HH:MM
Default: 23:59
|
| Link | url | |
| Link label | text |
Default: Shop the sale
|
Block: Free shipping progress max 1
Shows how much more the visitor needs to spend for free shipping. Uses the threshold in Theme settings > Cart.
Appsaddable
| Setting | Type | Details |
|---|---|---|
| Keep app content within the page width | checkbox |
Default: on
|
| Color scheme | color scheme |
Default: scheme-1
|
| Top padding | range |
Range: 0–100px
Default: 24
|
| Bottom padding | range |
Range: 0–100px
Default: 24
|
Blog postsaddable
| Setting | Type | Details |
|---|---|---|
| Heading | text |
Default: Guides and news
|
| Subheading | text | |
| Blog | blog | |
| Number of posts | range |
Range: 2–8
Default: 3
|
| Columns on desktop | select |
Options: 2, 3, 4
Default: 3
|
| Show date | checkbox |
Default: on
|
| Show author | checkbox |
Default: off
|
| Show excerpt | checkbox |
Default: on
|
| Show 'View all' link | checkbox |
Default: on
|
| Color scheme | color scheme |
Default: scheme-1
|
| Top padding | range |
Range: 0–100px
Default: 48
|
| Bottom padding | range |
Range: 0–100px
Default: 48
|
Category gridaddable1 block type
| Setting | Type | Details |
|---|---|---|
| Heading | text |
Default: Shop by category
|
| Subheading | text | |
| Automatic categories from menu | link list |
Used when no category blocks are added. Collection links in this menu become tiles; if there are none, your largest collections are shown.
Default: main-menu
|
| Maximum automatic tiles | range |
Range: 4–16
Default: 8
|
| Tile style | select |
Options: Icon circle, Card
Default: circle
|
| Use collection images on automatic tiles | checkbox |
Default: off
|
| Columns on desktop | select |
Options: 4, 6, 8
Default: 8
|
| Show product counts | checkbox |
Default: on
|
| 'View all' label | text |
Default: All categories
|
| 'View all' link | url | |
| Color scheme | color scheme |
Default: scheme-1
|
| Top padding | range |
Range: 0–100px
Default: 48
|
| Bottom padding | range |
Range: 0–100px
Default: 48
|
Block: Category
| Setting | Type | Details |
|---|---|---|
| Collection | collection | |
| Label | text | Defaults to the collection title. |
| Icon | select |
Options: Automatic (from collection name), Networking, Cables, Power, Printing, Components, Storage, Peripherals, Monitors, Audio, VoIP, Conferencing, Security, Laptops, Mobile, Software, Smart home, Gaming, Servers, Deals, Tools, Electrical, Plumbing, Garden, Automotive, Paint, Safety, Generic grid, Truck, Clock, Shield, Returns, Lock, Tag, Gift, Box, Pin, Support, Chat, Mail, Star, Info, Calculator, Document, Globe, Phone, Check, Heart, Search, Cart, Account, Play
Default: detect
|
| Image | image picker | Optional. Replaces the icon. |
Collageaddable3 block types
| Setting | Type | Details |
|---|---|---|
| Heading | text |
Default: Shop the range
|
| Large tile | select |
Options: Left, Right
Default: left
|
| Color scheme | color scheme |
Default: scheme-1
|
| Top padding | range |
Range: 0–100px
Default: 40
|
| Bottom padding | range |
Range: 0–100px
Default: 40
|
Block: Image
| Setting | Type | Details |
|---|---|---|
| Image | image picker | |
| Caption | text |
Default: New season
|
| Link | url |
Block: Product
| Setting | Type | Details |
|---|---|---|
| Product | product |
Block: Collection
| Setting | Type | Details |
|---|---|---|
| Collection | collection |
Contact formaddable
| Setting | Type | Details |
|---|---|---|
| Heading | text |
Default: Get in touch
|
| Text | richtext |
Default: Questions, quotes or product advice — we usually reply within one business day.
|
| Show phone field | checkbox |
Default: on
|
| Show company field | checkbox |
Default: on
|
| Side panel | richtext | Opening hours, phone, address. Leave empty to hide. |
| Color scheme | color scheme |
Default: scheme-1
|
| Top padding | range |
Range: 0–100px
Default: 24
|
| Bottom padding | range |
Range: 0–100px
Default: 48
|
Custom Liquidaddable
| Setting | Type | Details |
|---|---|---|
| Liquid code | liquid | Add app snippets or other Liquid code to create advanced customisations. |
| Limit to page width | checkbox |
Default: on
|
| Color scheme | color scheme |
Default: scheme-1
|
| Top padding | range |
Range: 0–100px
Default: 32
|
| Bottom padding | range |
Range: 0–100px
Default: 32
|
FAQaddable1 block type
| Setting | Type | Details |
|---|---|---|
| Eyebrow | text |
Default: Help centre
|
| Heading | text |
Default: Frequently asked questions
|
| Text | richtext |
Default: Can't find what you're looking for? Our team is here to help.
|
| Button label | text |
Default: Contact us
|
| Button link | url | |
| Layout | select |
Options: Intro beside questions, Intro above questions
Default: split
|
| Open the first question | checkbox |
Default: off
|
| Add FAQ structured data (SEO) | checkbox |
Use only once per page.
Default: on
|
| Color scheme | color scheme |
Default: scheme-1
|
| Top padding | range |
Range: 0–100px
Default: 48
|
| Bottom padding | range |
Range: 0–100px
Default: 48
|
Block: Question
| Setting | Type | Details |
|---|---|---|
| Question | text |
Default: Do you offer business accounts?
|
| Answer | richtext |
Default: Yes. Business customers get trade pricing, quotes and invoice payment options.
|
Featured collectionaddable1 block type
| Setting | Type | Details |
|---|---|---|
| Heading | text |
Default: Best sellers
|
| Subheading | text | |
| Collection | collection | Leave empty to show all products. Ignored when collection tabs are added. |
| Maximum products | range |
Range: 2–24
Default: 8
|
| Layout | select |
Options: Grid, Scrolling carousel
Default: carousel
|
| Columns on desktop | range |
Range: 2–6
Default: 5
|
| Columns on mobile (grid) | select |
Options: 1, 2
Default: 2
|
| Show 'View all' link | checkbox |
Default: on
|
| 'View all' label | text |
Default: View all
|
| Color scheme | color scheme |
Default: scheme-1
|
| Top padding | range |
Range: 0–100px
Default: 48
|
| Bottom padding | range |
Range: 0–100px
Default: 48
|
Block: Collection tab
| Setting | Type | Details |
|---|---|---|
| Collection | collection | |
| Tab label | text | Defaults to the collection title. |
Featured productaddable
| Setting | Type | Details |
|---|---|---|
| Heading | text | |
| Product | product | |
| Show description | checkbox |
Default: on
|
| Image position | select |
Options: Left, Right
Default: left
|
| Color scheme | color scheme |
Default: scheme-1
|
| Top padding | range |
Range: 0–100px
Default: 40
|
| Bottom padding | range |
Range: 0–100px
Default: 40
|
Hero slideraddable1 block type
| Setting | Type | Details |
|---|---|---|
| Use the store cover image for slides without an image | checkbox |
The cover image from Settings > Brand. Turn off if that image has text on it, so it does not clash with the slide text.
Default: on
|
| Height | select |
Options: Small, Medium, Large, Adapt to first image
Default: medium
|
| Full width | checkbox |
Default: on
|
| Auto-rotate slides | checkbox |
Starts once the shopper scrolls or interacts with the page, pauses on hover and focus and when off screen, and stays off for visitors who prefer reduced motion.
Default: on
|
| Change slides every | range |
Range: 3–10s
Default: 6
|
| Show arrows | checkbox |
Default: on
|
| Show dots | checkbox |
Default: on
|
| Section color scheme | color scheme |
Default: scheme-1
|
| Top padding | range |
Range: 0–100px
Default: 0
|
| Bottom padding | range |
Range: 0–100px
Default: 0
|
Block: Slide
| Setting | Type | Details |
|---|---|---|
| Image | image picker | 2400 x 1000px recommended. Without an image the slide shows a gradient in the slide's color scheme. |
| Mobile image | image picker | Optional. 1100 x 1300px recommended. |
| Image overlay opacity | range |
Range: 0–90%
Default: 35
|
| Illustration (no image) | select |
Options: None, Networking, Cables, Power, Printing, Components, Storage, Peripherals, Monitors, Audio, VoIP, Conferencing, Security, Laptops, Mobile, Software, Smart home, Gaming, Servers, Deals, Tools, Electrical, Plumbing, Garden, Automotive, Paint, Safety, Generic grid, Truck, Clock, Shield, Returns, Lock, Tag, Gift, Box, Pin, Support, Chat, Mail, Star, Info, Calculator, Document, Globe, Phone, Check, Heart, Search, Cart, Account, Play
Default: networking
|
| Eyebrow | text |
Default: New season tech
|
| Heading | text |
Default: Slide heading
|
| Text | richtext |
Default: Tell customers what makes this collection worth a look.
|
| First button label | text |
Default: Shop now
|
| First button link | url | |
| Second button label | text | |
| Second button link | url | |
| Text alignment | select |
Options: Left, Center, Right
Default: left
|
| Content position (horizontal) | select |
Options: Left, Center, Right
Default: left
|
| Content position (vertical) | select |
Options: Top, Middle, Bottom
Default: middle
|
| Show background behind text | checkbox |
Default: off
|
| Slide color scheme | color scheme |
Sets text, buttons, overlay and the no-image gradient.
Default: scheme-3
|
Image with textaddable
| Setting | Type | Details |
|---|---|---|
| Image | image picker | |
| Illustration (no image) | select |
Options: Networking, Cables, Power, Printing, Components, Storage, Peripherals, Monitors, Audio, VoIP, Conferencing, Security, Laptops, Mobile, Software, Smart home, Gaming, Servers, Deals, Tools, Electrical, Plumbing, Garden, Automotive, Paint, Safety, Generic grid, Truck, Clock, Shield, Returns, Lock, Tag, Gift, Box, Pin, Support, Chat, Mail, Star, Info, Calculator, Document, Globe, Phone, Check, Heart, Search, Cart, Account, Play
Default: support
|
| Image shape | select |
Options: Original, Square, Landscape, Portrait
Default: 4/3
|
| Image position on desktop | select |
Options: Left, Right
Default: left
|
| Content vertical alignment | select |
Options: Top, Middle, Bottom
Default: middle
|
| Text alignment | select |
Options: Left, Center
Default: left
|
| Eyebrow | text |
Default: Trade & business
|
| Heading | text |
Default: Expert advice from people who install it
|
| Text | richtext |
Default: Not sure which switch, UPS or access point you need? Our team helps you spec the right gear for the job.
|
| First button label | text |
Default: Talk to us
|
| First button link | url | |
| Second button label | text | |
| Second button link | url | |
| Color scheme | color scheme |
Default: scheme-1
|
| Top padding | range |
Range: 0–100px
Default: 48
|
| Bottom padding | range |
Range: 0–100px
Default: 48
|
Multicolumnaddable1 block type
| Setting | Type | Details |
|---|---|---|
| Heading | text |
Default: Why buy from us
|
| Subheading | text | |
| Columns on desktop | select |
Options: 2, 3, 4
Default: 3
|
| Style | select |
Options: Plain, Cards
Default: card
|
| Alignment | select |
Options: Left, Center
Default: left
|
| Color scheme | color scheme |
Default: scheme-1
|
| Top padding | range |
Range: 0–100px
Default: 48
|
| Bottom padding | range |
Range: 0–100px
Default: 48
|
Block: Column
| Setting | Type | Details |
|---|---|---|
| Icon | select |
Options: None, Networking, Cables, Power, Printing, Components, Storage, Peripherals, Monitors, Audio, VoIP, Conferencing, Security, Laptops, Mobile, Software, Smart home, Gaming, Servers, Deals, Tools, Electrical, Plumbing, Garden, Automotive, Paint, Safety, Generic grid, Truck, Clock, Shield, Returns, Lock, Tag, Gift, Box, Pin, Support, Chat, Mail, Star, Info, Calculator, Document, Globe, Phone, Check, Heart, Search, Cart, Account, Play
Default: support
|
| Image | image picker | Replaces the icon. |
| Heading | text |
Default: Column heading
|
| Text | richtext |
Default: Short supporting text for this column.
|
| Link label | text | |
| Link | url |
Multirowaddable1 block type
| Setting | Type | Details |
|---|---|---|
| Heading | text | |
| First image | select |
Options: Left, Right
Default: left
|
| Alternate image sides | checkbox |
Default: on
|
| Image ratio | select |
Options: Landscape (4:3), Square, Wide (16:9)
Default: 4 / 3
|
| Text alignment | select |
Options: Left, Center
Default: left
|
| Button style | select |
Options: Primary, Secondary
Default: secondary
|
| Color scheme | color scheme |
Default: scheme-1
|
| Top padding | range |
Range: 0–100px
Default: 40
|
| Bottom padding | range |
Range: 0–100px
Default: 40
|
Block: Row
| Setting | Type | Details |
|---|---|---|
| Image | image picker | |
| Eyebrow | text | |
| Heading | text |
Default: Tell your story
|
| Text | richtext |
Default: Pair an image with a short paragraph about a product, a service step or what makes your business different.
|
| Button label | text |
Default: Learn more
|
| Button link | url |
Newsletteraddable
| Setting | Type | Details |
|---|---|---|
| Heading | text |
Default: Get deals and new arrivals first
|
| Text | richtext |
Default: One useful email a fortnight. Unsubscribe any time.
|
| Button label | text |
Default: Subscribe
|
| Small print | inline richtext |
Default: We respect your privacy and never share your email.
|
| Background image | image picker | Turns the section into an email sign-up banner. Use a wide image, at least 1920 px. |
| Image overlay | range |
Range: 0–90%
Default: 40
|
| Show as a box | checkbox |
Default: on
|
| Box color scheme | color scheme |
Default: scheme-4
|
| Section color scheme | color scheme |
Default: scheme-1
|
| Top padding | range |
Range: 0–100px
Default: 48
|
| Bottom padding | range |
Range: 0–100px
Default: 48
|
Quick order listaddable
| Setting | Type | Details |
|---|---|---|
| Heading | text |
Default: Quick order
|
| Text | richtext | |
| Products | select |
On a product page, Current product lists every variant. Collection lists the chosen collection, or the current collection on collection pages.
Options: Current product (product pages), Collection
Default: collection
|
| Collection | collection | |
| Products per page | range |
Range: 5–50
Default: 25
|
| Show images | checkbox |
Default: on
|
| Show SKU | checkbox |
Default: on
|
| Show stock status | checkbox |
Default: on
|
| Hide sold-out variants | checkbox |
Default: off
|
| Search box and in-cart status | checkbox |
Adds a search box that filters the whole list as shoppers type, every page included, and marks the products already in the cart. Needs a Full licence.
Default: off
|
| Category picker | checkbox |
Adds a dropdown of the collections linked in the menu below, so shoppers can switch the list to another category. The collection chosen above is preselected. Needs a Full licence.
Default: off
|
| Category picker menu | link list | Collections linked in this menu, up to three levels, become the categories. Leave blank to use the main menu. |
| Color scheme | color scheme |
Default: scheme-1
|
| Top padding | range |
Range: 0–100px
Default: 40
|
| Bottom padding | range |
Range: 0–100px
Default: 40
|
Related productsaddable
Recommendations are made automatically by Shopify and can be adjusted in the Search & Discovery app.
| Setting | Type | Details |
|---|---|---|
| Heading | text |
Default: You may also like
|
| Maximum products | range |
Range: 2–10
Default: 4
|
| Columns on desktop | range |
Range: 2–6
Default: 4
|
| Swipe on mobile | checkbox |
Default: on
|
| Color scheme | color scheme |
Default: scheme-1
|
| Top padding | range |
Range: 0–100px
Default: 48
|
| Bottom padding | range |
Range: 0–100px
Default: 48
|
Rich textaddable
| Setting | Type | Details |
|---|---|---|
| Eyebrow | text | |
| Heading | text |
Default: Tech for work, home and the job site
|
| Heading size | select |
Options: Medium, Large
Default: medium
|
| Text | richtext |
Default: Share your store's story, a promise or an announcement.
|
| First button label | text | |
| First button link | url | |
| Second button label | text | |
| Second button link | url | |
| Alignment | select |
Options: Left, Center
Default: center
|
| Width | select |
Options: Narrow, Wide
Default: narrow
|
| Color scheme | color scheme |
Default: scheme-1
|
| Top padding | range |
Range: 0–100px
Default: 48
|
| Bottom padding | range |
Range: 0–100px
Default: 48
|
Trust baraddable1 block type
| Setting | Type | Details |
|---|---|---|
| Style | select |
Options: Row with dividers, Cards
Default: row
|
| Show payment icons | checkbox |
Default: off
|
| Extra payment logos | text | Comma separated, e.g. afterpay,zip,klarna |
| Show bank transfer badge | checkbox |
Default: off
|
| Color scheme | color scheme |
Default: scheme-2
|
| Top padding | range |
Range: 0–100px
Default: 24
|
| Bottom padding | range |
Range: 0–100px
Default: 24
|
Block: Trust item
| Setting | Type | Details |
|---|---|---|
| Icon | select |
Options: Networking, Cables, Power, Printing, Components, Storage, Peripherals, Monitors, Audio, VoIP, Conferencing, Security, Laptops, Mobile, Software, Smart home, Gaming, Servers, Deals, Tools, Electrical, Plumbing, Garden, Automotive, Paint, Safety, Generic grid, Truck, Clock, Shield, Returns, Lock, Tag, Gift, Box, Pin, Support, Chat, Mail, Star, Info, Calculator, Document, Globe, Phone, Check, Heart, Search, Cart, Account, Play
Default: truck
|
| Title | text |
Default: Fast dispatch
|
| Text | inline richtext |
Default: Same-day dispatch on orders before 1pm
|
| Link | url |
Videoaddable
| Setting | Type | Details |
|---|---|---|
| Heading | text |
Default: See it in action
|
| Subheading | text | |
| Video source | select |
Options: YouTube or Vimeo, Uploaded to Shopify
Default: external
|
| YouTube or Vimeo link | video url | |
| Shopify-hosted video | video | |
| Cover image | image picker | Shown until the video is played. The video only loads when clicked. |
| Video description | text | Describes the video for screen readers. |
| Aspect ratio | select |
Options: 16:9, 4:3, 21:9
Default: 16/9
|
| Full width | checkbox |
Default: off
|
| Color scheme | color scheme |
Default: scheme-1
|
| Top padding | range |
Range: 0–100px
Default: 48
|
| Bottom padding | range |
Range: 0–100px
Default: 48
|
404 page
| Setting | Type | Details |
|---|---|---|
| Heading | text |
Default: We couldn't find that page
|
| Text | richtext |
Default: The link may be old or the product may have moved. Try a search, or browse a popular category.
|
| Show popular collections | checkbox |
Default: on
|
| Collections heading | text |
Default: Popular categories
|
| Collections | collection list | Leave empty to show your largest collections. |
| Color scheme | color scheme |
Default: scheme-1
|
| Top padding | range |
Range: 0–100px
Default: 48
|
| Bottom padding | range |
Range: 0–100px
Default: 64
|
Blog
| Setting | Type | Details |
|---|---|---|
| Posts per page | range |
Range: 3–24
Default: 9
|
| Columns on desktop | select |
Options: 2, 3, 4
Default: 3
|
| Show tag filter | checkbox |
Tags that start with an underscore (for example _internal) are never shown, on the blog or on articles. Use them for tags only your store needs.
Default: on
|
| Show date | checkbox |
Default: on
|
| Show author | checkbox |
Default: on
|
| Show excerpt | checkbox |
Default: on
|
| Color scheme | color scheme |
Default: scheme-1
|
| Top padding | range |
Range: 0–100px
Default: 36
|
| Bottom padding | range |
Range: 0–100px
Default: 48
|
Blog post
| Setting | Type | Details |
|---|---|---|
| Show featured image | checkbox |
Default: on
|
| Show date | checkbox |
Default: on
|
| Show author | checkbox |
Default: on
|
| Show share links | checkbox |
Default: on
|
| Show related posts (same tags) | checkbox |
Default: on
|
| Add article structured data (SEO) | checkbox |
Default: on
|
| Color scheme | color scheme |
Default: scheme-1
|
| Top padding | range |
Range: 0–100px
Default: 36
|
| Bottom padding | range |
Range: 0–100px
Default: 48
|
Cart
| Setting | Type | Details |
|---|---|---|
| Color scheme | color scheme |
Default: scheme-1
|
| Suggest products | checkbox |
From the collection set in Theme settings > Cart.
Default: on
|
| Suggestions heading | text |
Default: Frequently added
|
| Empty cart suggestions heading | text |
Default: Popular right now
|
| Show express checkout buttons | checkbox |
Default: on
|
| Show payment icons | checkbox |
Default: on
|
| Extra payment icons | text |
Comma list, e.g. afterpay,zip,klarna
Default: afterpay,zip
|
| Top padding | range |
Range: 0–100px
Default: 32
|
| Bottom padding | range |
Range: 0–100px
Default: 48
|
Cart drawer
| Setting | Type | Details |
|---|---|---|
| Color scheme | color scheme |
Default: scheme-1
|
| Suggest products | checkbox |
From the collection set in Theme settings > Cart.
Default: on
|
| Suggestions heading | text |
Default: Frequently added
|
| Empty cart suggestions heading | text |
Default: Popular right now
|
| Show express checkout buttons | checkbox |
Default: on
|
Collection2 block types
Collection header
| Setting | Type | Details |
|---|---|---|
| Show image or category icon | checkbox |
Default: on
|
| Use collection image when set | checkbox |
Otherwise a category icon is chosen from the collection name.
Default: on
|
| Show product count | checkbox |
Default: on
|
| Show description | checkbox |
Default: on
|
| Subcollection menu | link list | Shown as chips under the header when no subcollection blocks are added. |
Filters and sorting
| Setting | Type | Details |
|---|---|---|
| Enable filtering | checkbox |
Customise filters with the Shopify Search & Discovery app.
Default: on
|
| Desktop filter layout | select |
Options: Left sidebar, Horizontal bar, Drawer
Default: sidebar
|
| Enable sorting | checkbox |
Default: on
|
| Show grid/list toggle | checkbox |
Default: on
|
| Default view | select |
Options: Grid, List
Default: grid
|
Product grid
| Setting | Type | Details |
|---|---|---|
| Products per page | range |
Range: 8–48
Default: 24
|
| Columns on desktop | range |
Range: 2–6
Default: 4
|
| Columns on tablet | range |
Range: 2–4
Default: 3
|
| Columns on mobile | select |
Options: 1, 2
Default: 2
|
| Pagination | select |
Infinite scroll loads up to four more pages as the shopper scrolls, then shows a Load more button so the footer stays reachable.
Options: Page numbers, Load more button, Infinite scroll
Default: numbers
|
| Add product list structured data (SEO) | checkbox |
Default: on
|
Section
| Setting | Type | Details |
|---|---|---|
| Color scheme | color scheme |
Default: scheme-1
|
| Top padding | range |
Range: 0–100px
Default: 24
|
| Bottom padding | range |
Range: 0–100px
Default: 48
|
Block: Promo tile
Shows in the product grid on the first page of the collection when no filters are applied.
| Setting | Type | Details |
|---|---|---|
| Grid position | range |
Range: 1–24
Default: 3
|
| Span two columns on desktop | checkbox |
Default: off
|
| Image | image picker | |
| Small label above the heading | text | |
| Heading | text |
Default: Bundle and save
|
| Text | textarea |
Default: Point shoppers to a deal, a guide or a related collection.
|
| Link | url | |
| Button label | text |
Default: Shop now
|
| Color scheme | color scheme |
Default: scheme-2
|
Block: Subcollection chip
| Setting | Type | Details |
|---|---|---|
| Collection | collection | |
| Label | text | Defaults to the collection title. |
| Icon | select |
Options: Automatic (from collection name), None, Networking, Cables, Power, Printing, Components, Storage, Peripherals, Monitors, Audio, VoIP, Conferencing, Security, Laptops, Mobile, Software, Smart home, Gaming, Servers, Deals, Tools, Electrical, Plumbing, Garden, Automotive, Paint, Safety, Generic grid, Truck, Clock, Shield, Returns, Lock, Tag, Gift, Box, Pin, Support, Chat, Mail, Star, Info, Calculator, Document, Globe, Phone, Check, Heart, Search, Cart, Account, Play
Default: detect
|
Collections list
| Setting | Type | Details |
|---|---|---|
| Heading | text |
Default: Shop by category
|
| Subheading | text | |
| Sort collections | select |
Options: Alphabetically, A-Z, Most products first, Fewest products first, Newest first, Oldest first
Default: alphabetical
|
| Tile style | select |
Options: Card (image or icon), Icon circle
Default: card
|
| Use collection images when available | checkbox |
Collections without an image show a category icon.
Default: on
|
| Show product count | checkbox |
Default: on
|
| Hide empty collections | checkbox |
Default: on
|
| Columns on desktop | range |
Range: 2–8
Default: 5
|
| Columns on mobile | select |
Options: 1, 2, 3
Default: 2
|
| Collections per page | range |
Range: 12–48
Default: 48
|
| Color scheme | color scheme |
Default: scheme-1
|
| Top padding | range |
Range: 0–100px
Default: 36
|
| Bottom padding | range |
Range: 0–100px
Default: 48
|
Complementary products
Header1 block type
| Setting | Type | Details |
|---|---|---|
| Color scheme | color scheme |
Default: scheme-1
|
| Layout | select |
Two rows puts a large search bar beside the logo and the menu on a row below. One row puts the menu beside the logo and search behind an icon.
Options: Two rows (search bar), One row (menu beside logo)
Default: two_rows
|
| Sticky header | select |
Options: Always, When scrolling up, None
Default: always
|
Search
| Setting | Type | Details |
|---|---|---|
| Show search bar | checkbox |
Search suggestions are set in Theme settings > Shopping tools.
Default: on
|
| Search placeholder | text | Leave empty for the default text. |
Navigation
| Setting | Type | Details |
|---|---|---|
| Menu | link list |
Up to three levels. Top-level items with sub-items open a full-width mega menu.
Default: main-menu
|
| Show 'All categories' button | checkbox |
Default: on
|
| 'All categories' label | text | Leave empty for the default text. |
| Customer account menu | link list |
Links shown in the account sheet. Use customer-account-main-menu to match the links on the customer account pages.
Default: customer-account-main-menu
|
| 'All categories' menu | link list | Defaults to the main menu. |
| Show category icons | checkbox |
Matched by menu item name, e.g. Networking, Cables, Power, Audio, Security, Tools.
Default: on
|
Icons
| Setting | Type | Details |
|---|---|---|
| Wishlist page | page | The wishlist icon shows when wishlist is on in Theme settings and a page is chosen. |
| Show compare icon | checkbox |
Default: off
|
Utility bar
| Setting | Type | Details |
|---|---|---|
| Show utility bar (desktop) | checkbox |
Default: on
|
| Text | inline richtext |
Default: Trade and business accounts available
|
| Phone number | text | |
| Show country/currency selector | checkbox |
Shown when the store sells to more than one country.
Default: on
|
| Show language selector | checkbox |
Shown when the store has more than one language.
Default: on
|
Block: Mega menu promo
| Setting | Type | Details |
|---|---|---|
| Menu item | text | Exact name of the top-level menu item to show this promo in. |
| Image | image picker | |
| Heading | text |
Default: Deals of the week
|
| Text | text | |
| Link | url | |
| Link label | text |
Default: Shop now
|
Page
| Setting | Type | Details |
|---|---|---|
| Show page title | checkbox |
Default: on
|
| Content width | select |
Options: Narrow, Wide
Default: narrow
|
| Color scheme | color scheme |
Default: scheme-1
|
| Top padding | range |
Range: 0–100px
Default: 36
|
| Bottom padding | range |
Range: 0–100px
Default: 36
|
Password page
| Setting | Type | Details |
|---|---|---|
| Eyebrow | text |
Default: Coming soon
|
| Heading | text |
Default: Something great is on the way
|
| Text | richtext |
Shown when no password message is set in Online Store preferences.
Default: We're stocking the shelves. Leave your email and we'll tell you the moment we open.
|
| Show email signup | checkbox |
Default: on
|
| Color scheme | color scheme |
Default: scheme-3
|
Pickup availability
Product information23 block types
| Setting | Type | Details |
|---|---|---|
| Color scheme | color scheme |
Default: scheme-1
|
Media
| Setting | Type | Details |
|---|---|---|
| Image shape | select |
Options: Square, Portrait, Landscape
Default: 1/1
|
| Image fit | select |
Options: Show whole image, Fill (crop)
Default: contain
|
| Thumbnails on desktop | select |
Stacked shows every image one under another on desktop; phones keep the swipe gallery.
Options: Below image, Left of image, Stacked (no thumbnails)
Default: bottom
|
| Click image to zoom | checkbox |
Default: on
|
| Loop videos | checkbox |
Default: off
|
Layout
| Setting | Type | Details |
|---|---|---|
| Keep product info visible while scrolling (desktop) | checkbox |
Default: on
|
| Description, specifications and other rows | select |
Tabs group two or more rows that sit next to each other in the block list. The first open row starts selected.
Options: Accordions, Tabs
Default: accordion
|
| Top padding | range |
Range: 0–100px
Default: 24
|
| Bottom padding | range |
Range: 0–100px
Default: 48
|
Block: Brand max 1
| Setting | Type | Details |
|---|---|---|
| Link to brand products | checkbox |
Default: on
|
Block: Title max 1
No settings.
Block: SKU and part numbers max 1
| Setting | Type | Details |
|---|---|---|
| Show barcode | checkbox |
Default: off
|
| Barcode label | text |
Default: EAN
|
| Manufacturer part number metafield | text |
namespace.key of a text metafield (variant or product), e.g. custom.mpn
Default: custom.mpn
|
Block: Price max 1
| Setting | Type | Details |
|---|---|---|
| Show saving | checkbox |
Default: on
|
| Show tax/region note | checkbox |
Default: on
|
Block: Badges max 1
No settings.
Block: Pay later messaging max 1
Providers and limits are set in Theme settings > Payment messaging.
Block: Variant picker max 1
| Setting | Type | Details |
|---|---|---|
| Style | select |
Options: Buttons, Dropdown
Default: buttons
|
| Show color swatches | checkbox |
Uses the swatches set on option values.
Default: on
|
Block: Quantity max 1
| Setting | Type | Details |
|---|---|---|
| Show volume pricing (B2B) | checkbox |
Default: on
|
Block: Buy buttons max 1
Store mode (shop, quote, catalogue) is set in Theme settings > Store mode.
| Setting | Type | Details |
|---|---|---|
| Show dynamic checkout buttons | checkbox |
Default: on
|
| Show gift card recipient form | checkbox |
Gift card products only. Lets shoppers send the card to someone else by email on a chosen date. Dynamic checkout buttons are hidden on gift cards while this is on.
Default: on
|
Block: Stock status max 1
No settings.
Block: Pickup availability max 1
No settings.
Block: Trust and payments max 1
| Setting | Type | Details |
|---|---|---|
| Show payment icons | checkbox |
Default: on
|
| Extra payment icons | text | Comma list, e.g. afterpay,zip,klarna |
| Show bank transfer icon | checkbox |
Default: off
|
Block: Gift with purchase max 1
Shows when the product has a promo_gift metafield (namespace set in Theme settings > Product cards and badges) that has not expired.
Block: Wishlist, compare, share max 1
| Setting | Type | Details |
|---|---|---|
| Wishlist | checkbox |
Default: on
|
| Compare | checkbox |
Default: on
|
| Share | checkbox |
Default: on
|
Block: Description max 1
| Setting | Type | Details |
|---|---|---|
| Heading | text |
Default: Description
|
| Open by default | checkbox |
Default: on
|
Block: Shipping and returns max 1
| Setting | Type | Details |
|---|---|---|
| Heading | text |
Default: Shipping and returns
|
| Open by default | checkbox |
Default: off
|
| Content | richtext | |
| Content from page | page |
Block: Collapsible tab
| Setting | Type | Details |
|---|---|---|
| Heading | text |
Default: Warranty
|
| Icon | select |
Options: None, Info, Shield, Truck, Return, Box, Tools, Support, Document, Power
Default: shield
|
| Open by default | checkbox |
Default: off
|
| Content | richtext | |
| Content from page | page |
Block: Compatibility table max 1
Shows the products or models this item works with, from a product metafield. Hidden when the product has no entries. Needs a Full licence.
| Setting | Type | Details |
|---|---|---|
| Heading | text |
Default: Compatibility
|
| Open by default | checkbox |
Default: off
|
| Text above the table | richtext | |
| Compatibility metafield | text |
namespace.key, e.g. custom.compatible_models. Use a list of text entries or a multi-line text field (one entry per line; split columns with |, e.g. Leader Tab7 | Confirmed), or a list of metaobjects.
Default: custom.compatible_models
|
| Column headings | text |
Comma-separated, e.g. Model, Notes. Shown when entries have more than one column.
Default: Model, Notes
|
| Metaobject fields | text |
For a list of metaobjects only: the field keys to show as columns, comma-separated.
Default: model, notes
|
Block: Product FAQ max 1
Shows questions and answers for this product, from a product metafield. Hidden when the product has none. Needs a Full licence.
| Setting | Type | Details |
|---|---|---|
| Heading | text |
Default: Questions and answers
|
| Open by default | checkbox |
Default: off
|
| FAQ metafield | text |
namespace.key, e.g. custom.faqs. Use a list of metaobjects with question and answer fields, or JSON like [{"question": "…", "answer": "…"}].
Default: custom.faqs
|
| Add FAQ structured data | checkbox |
Adds FAQPage data for search engines.
Default: on
|
Block: Bought together max 1
Uses complementary products set in the Search & Discovery app.
| Setting | Type | Details |
|---|---|---|
| Heading | text |
Default: Frequently bought together
|
| Products | range |
Range: 1–3
Default: 3
|
Block: Custom Liquid
| Setting | Type | Details |
|---|---|---|
| Custom Liquid | liquid |
Block: Text
| Setting | Type | Details |
|---|---|---|
| Text | richtext |
Default: Add a short note about this product.
|
| Style | select |
Options: Body, Subtle, Callout box
Default: body
|
Block: Image / promo
| Setting | Type | Details |
|---|---|---|
| Image | image picker | |
| Link | url | |
| Caption | text |
Search results
| Setting | Type | Details |
|---|---|---|
| Popular searches menu | link list | Shown before a search is made. |
| Enable filtering | checkbox |
Default: on
|
| Desktop filter layout | select |
Options: Left sidebar, Horizontal bar, Drawer
Default: sidebar
|
| Enable sorting | checkbox |
Default: on
|
| Show grid/list toggle | checkbox |
Default: on
|
| Results per page | range |
Range: 8–48
Default: 24
|
| Columns on desktop | range |
Range: 2–6
Default: 4
|
| Columns on mobile | select |
Options: 1, 2
Default: 2
|
| Pagination | select |
Infinite scroll loads up to four more pages as the shopper scrolls, then shows a Load more button so the footer stays reachable.
Options: Page numbers, Load more button, Infinite scroll
Default: numbers
|
| Color scheme | color scheme |
Default: scheme-1
|
| Top padding | range |
Range: 0–100px
Default: 32
|
| Bottom padding | range |
Range: 0–100px
Default: 48
|