Skip to content

Search is only available in production builds. Try building and previewing the site to test it out locally.

Commerce blocks

Product List Page

Customers browse products, filter selections, and sort results through this block. Place it on category and search results pages.

Product List Page block.

Product List Page block.

Configuration

Add this table to your document to configure the block:

product-list-page
Urlpath/path/to/page (example)

Property descriptions

Urlpath: Specifies the category path to display products from. Use this to create category-specific product listing pages. For example, /women/dresses shows products from the dresses category. Set this when creating a dedicated category page. Leave empty for search result pages.

Important notes

  • URL paths must point to valid pages on your site for navigation to work correctly.

Section metadata

Control the section styling, spacing, and layout that wraps your commerce block. All properties are optional:

section-metadata
Stylelight (optional)
Paddingmedium (optional)
Marginsmall (optional)
Column Width30% (optional)
Gapsmall (optional)

Learn more: See the Section Metadata guide for all available values and the Page Metadata guide for SEO and caching options.