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. |