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 bundleThe 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 tabWhether to hide the “add to cart” button on every product. Written as one word, with no hyphens.Defaults to
falseWhether 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
Whether to show the quantity field for the product.Defaults to the Show Quantity Selector setting on the Collection tab
Whether to show a “show more” link.Defaults to the Show “More” Link setting on the Collection tab
Whether to show the product description.Defaults to the Show Description setting on the Collection tab
Whether to show subscriber pricing information.Defaults to the Show Subscriber Pricing setting on the Collection tab
Columns on a phone.
columns-tablet, columns-desktop and columns-large set the wider breakpoints.Defaults to the Grid Columns setting on the Collection tabStyling
The following parts are available to style the collection component: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 asCase 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.
