Skip to content
  1. Extras
  2. PageBuilder
  3. Recipes
  4. Products grid

Products grid

Result: the page shows cards with a photo, a price, and an Add to cart button. msProducts runs inside the chunk. The template does not need its own snippet call. Requires PageBuilder Pro and miniShop3 (requires: ["pro", "minishop3"]).

Before you start

  1. The resource is published and the template contains [[!PageBuilder]].
  2. miniShop3 is installed and the catalog has a category with products.
  3. products_grid is in the Blocks catalog. If it is missing, check requires.

Steps

  1. Add a products_grid section.
  2. In Catalog root pick a category. The field is required.
  3. Set Limit and sort: menuindex, popular, new, price_asc, price_desc. An unknown value sorts as menuindex.
  4. Save the resource.

Example fields

Catalog root 101 (an example, use your category). Limit 6. An empty limit becomes 12 in the chunk. Sort price_asc. For a "often bought" block use popular.

An empty category prints lexicon pagebuilder_fe_listing_empty_products ("No products in this category yet."). The section has "cacheable": false, so the page HTML cache does not freeze the listing.

A narrow strip uses products_carousel. A hand-picked SKU list uses curated_products.

What to check

The site shows cards from the category you picked. Changing sortby to price_asc lists products by ascending price. An empty category prints the lexicon string, not a blank block.

Rollback

Delete the section.

See also