Skip to content
Faith
⌘K
Skip to content

Product cards

Product card settings

Overview

The Product cards settings control how product cards look and behave everywhere they appear: collection pages, search results, featured collections, recommendations and other product grids. You can set the image shape, ratings, quick view, quick add, hover media, variant swatches, promotional taglines and an offer countdown, all in one place.

How to use

  1. In the theme editor, click Theme settings (the gear icon).
  2. Open Product cards.
  3. Set the Layout options: image ratio, corner radius, text alignment and color scheme.
  4. Turn on the features you want, such as Show product rating, Show quick view, Show the add button or Show an offer countdown.
  5. Click Save. Every product card in your store updates.

Settings

SettingsDescription
LayoutThe basic look of every product card.
Image ratioThe shape of the card image: Portrait, Portrait (5:4), Portrait (4:3), Portrait (2:3), Square, Landscape (3:2), Landscape (16:9) or Original (uses each image’s own shape). Default: Portrait.
Corner radiusRounds the card corners (0–40 px, in steps of 2). Default: 16 px.
Text alignmentAligns the card text: Left, Center or Right. Default: Left.
Keep the collection in the product linkWhen a shopper opens a product from a collection, the link keeps that collection. The breadcrumb and previous/next navigation on the product page then stay inside it. On by default.
Color schemeThe color scheme of the cards. Default: Scheme 3.
Match the image to the active filterWhen shoppers filter by a variant option such as color, each card shows the image of the matching variant. Off by default.
Show vendorShows the product vendor on the card. Off by default.
ReviewsStar ratings on the card.
Show product ratingShows star ratings on the card. Reads the rating and rating count product metafields that your reviews app writes. Off by default.
Show the score beside the starsShows the average score (for example, 4.8) next to the stars. On by default. Appears when Show product rating is on.
Show the review count onlyShows only the number of reviews instead of the score. Off by default. Appears when Show product rating is on.
Star colorThe color of the filled stars. Leave empty to use the theme’s accent color. Appears when Show product rating is on.
Empty star colorThe color of the unfilled part of the rating. Leave empty for a faint tint of the text color. Appears when Show product rating is on.
Text colorThe color of the score and review count. Leave empty to follow the surrounding text color. Appears when Show product rating is on.
Quick viewA popup that lets shoppers see product details and add to cart without leaving the page.
Show quick viewAdds a quick view button to product cards. On by default.
Button displayWhen the quick view button shows: On hover, Always, On hover, always on mobile or On hover, hidden on mobile. Default: On hover, always on mobile. Appears when Show quick view is on.
Color schemeThe color scheme of the quick view panel. Default: Scheme 1. Appears when Show quick view is on.
Quick view widthThe maximum width of the quick view panel (720–1280 px, in steps of 8). Default: 952 px. Appears when Show quick view is on.
Image column widthThe width of the image side of the panel (280–640 px, in steps of 8). Default: 400 px. Appears when Show quick view is on.
Space between columnsThe gap between the image and the product details (16–96 px, in steps of 4). Default: 56 px. Appears when Show quick view is on.
Inner paddingThe space inside the panel edges (16–64 px, in steps of 4). Default: 32 px. Appears when Show quick view is on.
Corner radiusRounds the panel corners (0–40 px). Default: 20 px. Appears when Show quick view is on.
Promotional taglineA scrolling message strip on the card.
Show promotional taglineReads the theme.tagline product metafield and scrolls it across the card. A product with a tagline shows it in place of the offer countdown, because both use the same strip. On by default.
Scroll speedHow fast the tagline scrolls: Slow, Medium, Fast or Very fast. Default: Medium. Appears when Show promotional tagline is on.
Color schemeThe color scheme of the tagline strip. Default: Scheme 4. Appears when Show promotional tagline is on.
VariantsHow product options show on the card.
Show sibling productsOff by default, so cards show the product’s own variant swatches. Turn it on if you sell each colorway as a separate product. It reads the theme.sibling_products metafield, or theme.siblings when the colorways are grouped as a collection.
Show variant swatchesShows color swatches for the product’s variants on the card. On by default.
CutlineA short line of text above the product title.
Show cutlineReads the theme.cutline product metafield and shows it above the product title. On by default.
Cutline colorThe cutline text color. Leave empty to use the scheme’s text color.
MediaWhat the card shows on hover.
Show second image on hoverShows the product’s second image when shoppers hover over the card. Products with only one image keep the featured image. On by default.
Play a second video on hoverIf the second media item is a video, the card plays it on hover instead of showing a still image. Nothing downloads until the shopper hovers, so it doesn’t slow down page loading. On by default. Appears when Show second image on hover is on.
Quick addA button that adds products to the cart straight from the card.
Show the add buttonProducts with one buyable variant are added straight from the card. When the shopper still needs to choose an option, the button opens quick view instead. On by default.
Button styleHow the button looks: Plus, Cart icon or Add to cart text. Default: Plus. Appears when Show the add button is on.
Size panelThe panel that opens over the image on hover, showing a variant option such as size. Choose which option it shows under Theme settings → Swatches → Single variation option.
Values to showThe maximum number of option values shown in the panel (2–10). Default: 6.
Show the chosen value beside the labelShows the selected value next to the option name (for example, “Size: M”). On by default.
Show the vendorShows the vendor as “Brand: …” opposite the option label. On by default.
Offer countdownA countdown strip across the bottom of the card image.
Show an offer countdownShows a countdown to a deadline stored in a product metafield. Products without that metafield get no strip, and a product with a promotional tagline shows the tagline instead. Off by default.
Deadline metafieldThe namespace and key of a product metafield of type Date or Date and time, for example custom.offer_ends_at. Create it in Settings → Custom data → Products, then set a deadline on each product. Cards with no deadline, or a deadline that has passed, show no countdown. Appears when Show an offer countdown is on.
Text before the clockText shown before the timer. Default: “Offer ends in”. Appears when Show an offer countdown is on.
Text after the clockOptional text shown after the timer. Appears when Show an offer countdown is on.
Count days as well as hoursShows days in the timer. Turn it off to count in hours only. On by default. Appears when Show an offer countdown is on.
Scroll the stripScrolls the countdown strip so a long message stays readable on narrow cards. On by default. Appears when Show an offer countdown is on.
Scroll speedHow fast the strip scrolls (10–100%, in steps of 5). Default: 40%. Appears when Scroll the strip is on.
Color schemeThe color scheme of the countdown strip. Default: Scheme 4. Appears when Show an offer countdown is on.
List view cardSettings for the row-style card in the collection list view.
Thumbnails beside the pictureThe number of small thumbnails in the rail beside the main image in list view (0–6). Set it to 0 to hide the rail. Default: 4.

Tip: To edit what appears inside the quick view (title, price, variant picker, buttons and more), open the Products › quickview template in the theme editor. This page only controls the panel’s size, colors and button.

Tip: The promotional tagline and the offer countdown share the same strip. Use the tagline for evergreen messages like “Best seller” and the countdown for time-limited sales.

Note: Ratings, taglines, cutlines, sibling products and countdowns all read product metafields. If a feature is on but nothing shows, check that the metafield exists and has a value on that product.

Was this helpful?
Previous Product badge Next Quick add & cart drawer