Skip to content

Product Row Card

The card used in Featured Products. Pulls everything from the selected product by default, with per-card overrides for merchandising copy that shouldn’t live on the product itself.

Setting What it does
Product The product to feature. Everything else falls back to this product’s own data.
Image Overrides the product’s featured image on the card.
Quick add modal image Optional. Overrides the shot shown inside the quick add modal, which otherwise reuses the card’s image. See Quick add modal image below.
Title override Replaces the product title on this card only.
Description override Replaces the product description.
URL override Sends the card somewhere other than the product page.
Button text Defaults to “Quick Add”.
Show price Toggles the price line.
Price prefix / suffix Wraps the price — “Starting at” … “per month”.
Footnote Small print under the card.
Setting What it does
Badge label Manual badge text. Leave empty to derive it from the product’s tags.
Badge colour Sun, Fern, Lavender or Sky. Manual mode only.
Badge star Adds a star icon. Manual mode only.

Badge colour and star are hidden in the customizer until you type a label — they only apply in manual mode.

With Badge label empty, the card reads the product’s tags and uses the first one that matches:

Product tag Badge Colour Star
best-seller or bestseller Best Seller Sun
new New Fern
hormonal Hormonal Lavender
ages-2-12, ages-2-to-12, ages-212 Ages 2-12 Sky

Matching ignores case and punctuation, so “Best Seller”, “best-seller” and “BEST SELLER” all resolve identically.

The tag rules live in snippets/tag-style-map.liquid — the single place they’re defined. Adding a new badge type means editing that one file; nothing that renders a badge needs to change.

When the parent section is in Quick add mode, the button adds to cart directly — but only if the product has exactly one variant and is in stock.

Multi-variant products need a variant picker, so those cards open the quick add modal instead, where the shopper chooses a pack size and delivery frequency. Nothing to configure; it just switches behaviour.

The quick add modal fills its left half with a product shot, cropped to bleed to the top, left and bottom edges. By default that’s the same image the card is showing — including this card’s own image override — so there is usually nothing to configure here.

Three places are checked, in order — the first one that has an image wins:

Order Source Use it when
1 Quick add modal image on this card You want the modal to show something different from the card.
2 The card’s image (its Image override, or the product’s main image) The normal path. Nothing to set.
3 The product’s main image Fallback when no card image was supplied.
  • Keep description overrides short. One line reads best; long copy pushes cards to uneven heights.
  • Override the image when the product’s featured image is a lifestyle shot — cards want the product on plain background.
  • Leave the modal image empty unless the card’s own image crops badly in the modal. It reuses the card image by default, so setting both is usually duplicated work.
  • Leave badges empty unless you specifically need a one-off. Tags scale.