Skip to main content

Component example

Props

Props should be passed as attributes to the component element.
The text to display after the price if the product type is bundle.E.g £99/pack, where pack is the bundle-text.Defaults to bundle
The path to the cart page.Defaults to /cart
required
The slug for the collection to display products from.
The text to display on the “add to cart” button.Defaults to the Add to Cart Button label (Add to Cart)
The text on the button a card shows instead of “add to cart” when its product has options to choose.Defaults to the See Options Button label (See options)
How the options chooser opens on this grid: modal or anchored.Defaults to the Popup Style setting on the Collection tab
boolean
Whether to hide the “add to cart” button on every product. Written as one word, with no hyphens.Defaults to false
number
The number of placeholder items to display while the products are loading.Defaults to 8
boolean
Whether to redirect to the cart page after adding the product to the cart.Defaults to the After Adding to Cart setting on the Collection tab
boolean
Whether to show the quantity field for the product.Defaults to the Show Quantity Selector setting on the Collection tab
boolean
Whether to show the name of the collection.Defaults to true
Whether to show a “show more” link.Defaults to the Show “More” Link setting on the Collection tab
The text to display on the “show more” link.Defaults to More
boolean
Whether to show the product description.Defaults to the Show Description setting on the Collection tab
The text to display on sale price badges.Defaults to Sale
The text to display on subscriber price badges.Defaults to Subscribers
The label text for subscriber pricing.Defaults to for subscribers
boolean
Whether to show subscriber pricing information.Defaults to the Show Subscriber Pricing setting on the Collection tab
boolean
Whether to show the date under an event’s name.Defaults to false
number
Columns on a phone. columns-tablet, columns-desktop and columns-large set the wider breakpoints.Defaults to the Grid Columns setting on the Collection tab

Styling

The following parts are available to style the collection component:
The containing div of placeholder items that is shown while the products are loading.
The colour of the placeholder items that is shown while the products are loading.
The containing ul of the products grid.
The containing li of a product.
The containing div of the product image.
The product image.
The container for the low stock badge.
The low stock badge element.
The containing div of the product info.
The product name.
The product price.
The product description container.
The price badge (sale/subscriber) element.
The sale price display.
The primary subscriber price (for logged-in subscribers).
The subscriber price information.
The crossed-out subscriber price.
The crossed-out regular price.
The crossed-out original price.
The upsell product selection container (visible on hover).
The upsell product dropdown container.
The upsell product select dropdown (hover state).
The “show more” link element.

Features

Product Card Styles

You can choose from four product card styles in your web component settings: Minimal (clean, no border), Bordered (subtle border), Elevated (shadow effect), or Filled (solid background). You can also control text alignment and image corner radius. Image Shape sets how tall each card’s image is, from Square to Tall, and Image Fit chooses between showing the whole image (Fit, best for bottle shots) and cropping it to fill the space (Fill, best for photos). The images fill the card’s width on every screen size.

Grid Spacing

Grid Spacing sets the space between products, from Tight to Spacious. It’s set with the grid columns on the Collection tab, and related products on the product page follow the same spacing, image shape and fit.

Background Colour

Set a custom background colour for your collection pages from web component settings. You can also give the product cards their own background, separate from the collection behind them. See Product Cards.

Restricted Collections

A collection can be restricted to certain markets. When a shopper is in a market the collection isn’t available in, the component explains why there’s nothing to show rather than rendering an empty grid, using the message and page you set on the collection.

Purchase Options

A product with upsells shows a See options button rather than an add-to-cart button, opening a chooser that lists every purchase option as a priced row: the product itself alongside its upsells, each with its own price and a quantity to multiply it by. Each option carries a short label, such as Case of 6, set on the product. Options that are out of stock report their own availability, so a shopper can’t pick a sold-out case and find out at the cart. The button’s wording and the label used for the product’s own row are set on the Labels tab. A product with a required text option also shows the See options button, linking to its product page, since a card has nowhere to type. Quantity steppers stop at a product’s per-customer limit. The collection component uses the add to cart component to display the “add to cart” button for each product. If you have set styles for the add to cart component they will be applied to the “add to cart” button with this component.