Products block


Shows products from a collection or from a hand-picked list, as a carousel or a grid, with an optional heading above.

Subheading

Setting Description
Subheading Short line above the heading. Supports inline formatting. Leave empty to hide it. The settings below appear only when a subheading is entered.
Preset Typography preset: Hero, H1–H6, Subheading, Caption, Large text, Paragraph or Small text. Presets are edited in Theme settings → Typography. Default: Subheading.
Icon Decorative icon before the text: None, Dot, Square or Triangle. Available only with the Subheading preset. Default: Triangle.
Icon color Color of the icon: Heading, Text, Accent or Custom. Available only with the Subheading preset and an icon selected. Default: Custom.
Icon custom Custom icon color. Available only when Icon color is Custom. Default: #2B62C8.
Icon custom dark mode Custom icon color used in dark mode. Available only when Icon color is Custom and dark mode is enabled in Theme settings. Default: #2B62C8.
Font Font family: Heading large, Heading small, Body or Accent. Default: Accent.
Color Text color: Heading, Text or Accent. Default: Accent.
Text style Letter case: Normal, Uppercase or Lowercase. Default: Uppercase.
Bottom space Space between the subheading and the heading. Shown when a heading or description is entered. Range: 0–60 px. Default: 40 px.
Bottom space mobile The same space on mobile. Range: 0–40 px. Default: 20 px.

Heading

Setting Description
Heading Block heading. Supports inline formatting. Leave empty to hide it. The settings below appear only when a heading is entered. Default: Featured collection.
Preset Typography preset (same options as the subheading). Default: H2.
Icon, Icon color, Icon custom, Icon custom dark mode Same as for the subheading; available only with the Subheading preset.
Font Font family: Heading large, Heading small, Body or Accent. Default: Heading large.
Color Text color: Heading, Text or Accent. Default: Heading.
Text style Letter case: Normal, Uppercase or Lowercase. Default: Normal.
Bottom space Space between the heading and the description. Shown when a description is entered. Range: 0–60 px. Default: 16 px.
Bottom space mobile The same space on mobile. Range: 0–40 px. Default: 8 px.

Description

Setting Description
Description Text under the heading. Supports inline formatting. Leave empty to hide it. The settings below appear only when a description is entered.
Preset Typography preset (same options as the subheading). Default: Paragraph.
Icon, Icon color, Icon custom, Icon custom dark mode Same as for the subheading; available only with the Subheading preset.
Font Font family: Heading large, Heading small, Body or Accent. Default: Body.
Color Text color: Heading, Text or Accent. Default: Text.
Text style Letter case: Normal, Uppercase or Lowercase. Default: Normal.
Header bottom space Space between the whole header (subheading, heading, description) and the products. Shown when any of them is entered. Range: 0–60 px. Default: 40 px.
Header bottom space mobile The same space on mobile. Range: 0–60 px. Default: 40 px.

Layout

Setting Description
Collection Collection whose products are shown. Ignored if a product list is selected.
Product list Hand-picked products. When selected, it is used instead of the collection.
Product count Maximum number of products shown. Range: 1–16. Default: 6.
Layout style Grid or Carousel. Default: Carousel.
Desktop columns Number of products per row on desktop. Range: 1–5. Default: 3.
Mobile columns Number of products per row on mobile: One or Two. Default: One.
Desktop horizontal spacing Space between products on desktop. Range: 0–60 px. Default: 8 px.
Mobile horizontal spacing Space between products on mobile. Range: 0–40 px. Default: 8 px.
Desktop vertical spacing Space between rows on desktop. Available only for the Grid layout. Range: 0–60 px. Default: 16 px.
Mobile vertical spacing Space between rows on mobile. Available only for the Grid layout. Range: 0–40 px. Default: 16 px.
Show view all Shows a “View all” button. The four settings below appear only when this is on. Default: Off.
View all label Button text. Default: View all.
View all link Page the button leads to. Defaults to the selected collection when left empty.
View all button style Primary, Secondary, Outline or Inline. Button styles are edited in Theme settings → Buttons. Default: Primary.
Button icon Icon next to the label: None, Dot, Square, Triangle, Arrow, Caret or Carets. Default: Dot.
Button icon position Places the icon to the left or right of the label. Available only when an icon is selected. Default: Right.
Show arrows Shows previous/next arrows on desktop. Available only for the Carousel layout. Default: On.
Show arrows on mobile Shows arrows on mobile. Available only for the Carousel layout. Default: Off.
Show scrollbar Shows a scrollbar under the carousel on desktop. Available only for the Carousel layout. Default: On.
Show scrollbar on mobile Shows the scrollbar on mobile. Available only for the Carousel layout. Default: On.
Full-width carousel bleed Lets the carousel peek past the page edge with a partial next card. Turn it off when the block sits inside a narrower container, for example a grid column. Available only for the Carousel layout. Default: On.

Product card

Setting Description
Color scheme Color scheme of the product cards. Schemes are managed in Theme settings → Colors. Default: Scheme 1.
Card background Background or Background secondary. Default: Background secondary.
Card style Standard, Card or Card with corners. Default: Standard.
Media size Shape of the product image: Adapt (original proportions), Portrait, Square, Landscape or Custom. Default: Adapt.
Custom media size Image height as a percentage of its width. Available only when Media size is Custom. Range: 40–180 %. Default: 100 %.
Heading size Size of the product title: Large, Medium, Small or Extra small. Default: Small.
Heading font Font of the product title: Heading large, Heading small, Body or Accent. Default: Heading large.
Heading color Color of the product title: Heading, Text or Accent. Default: Heading.
Heading text style Letter case of the product title: Normal, Uppercase or Lowercase. Default: Normal.
Show vendor Shows the product vendor. Default: Off.
Show type Shows the product type. Default: On.
Show price Shows the product price. Default: On.
Product icons Shows a row of icons next to the price. Create a product metafield of type “File → List of files” and enter its name here (for example “Product icons”). Only PNG and JPG files are supported; SVG files are skipped.
Show variant picker Shows color/size swatches on product cards. Default: Off.
Variant picker type First option only shows the first option, with its variants under the image; All variants shows every variant; Selected options shows only the options listed below. Available only when the variant picker is on. Default: First option only.
Options to show Comma-separated option names, for example Color, Size. Products without a matching option show no picker. Available only when the picker type is Selected options.
Show compare button Shows the compare button on cards. To turn compare on or off for the whole store and choose the compared fields, use the Compare popup settings section under Features in the theme editor sidebar. Default: On.
Quick add Standard or Bulk. Bulk shows a quantity selector on single-variant products, so customers can set the quantity straight from the grid. Default: Standard.
Products with variants How Bulk works for products with variants: Quick order drawer or Variant picker + quantity (needs the variant picker turned on; cards whose options can’t be resolved link to the product page). Available only when Quick add is Bulk. Default: Quick order drawer.

Padding

Setting Description
Top, Bottom, Left, Right Space around the block on desktop. Range: 0–100 px, step 1. Default: 0 px.
Top mobile, Bottom mobile, Left mobile, Right mobile Space around the block on mobile. Range: 0–100 px, step 1. Default: 0 px.
Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us