Skip to content
Faith
⌘K
Skip to content

Product Card

Overview

Product cards are the product tiles shown across the store: in collections, search results, Featured collection, Featured collection pills, Spotlight products, related products and more. Each card shows the product image, title and price, and can also show:

  • a second image or video on hover
  • star ratings
  • color swatches
  • a quick add (+) button and a quick view
  • badges
  • a scrolling promotional tagline or an offer countdown

All cards follow Theme settings → Product cards, so one change updates every card in the store. To change the cards in just one section, use that section’s Product card block (see the end of this article).

How to use

  1. Go to Online Store → Themes → Customize.
  2. Click the Theme settings icon (the gear) in the left sidebar and open Product cards.
  3. Under Layout, set the Image ratio, Corner radius, Text alignment and Color scheme.
  4. Under Reviews, turn on Show product rating if you use a reviews app, and choose the star colors.
  5. Set up Quick view, Variants, Media (hover image) and Quick add.
  6. Optionally, turn on the Promotional tagline, Cutline or Offer countdown. These read product metafields.
  7. Click Save.
  8. To override the cards in one section, open that section in the left sidebar, select its Product card block, and change only what you need.

Settings — Layout

SettingsDescription
Image RatioChoose the shape of the product images: Portrait, Portrait (5:4), Portrait (4:3), Portrait (2:3), Square, Landscape (3:2), Landscape (16:9) or Original.
Corner RadiusCustomize the rounded corners of the card image (0–40 px).
Text AlignmentAlign the card text Left, Center or Right.
Keep the Collection in the Product LinkWhen a product is opened from a collection, keep that collection in the link, so the breadcrumb and previous/next navigation stay inside it.
Color SchemeSelect a color scheme for the cards.
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.
Show VendorShow the product’s vendor (brand) on the card.

Settings — Reviews

SettingsDescription
Show Product RatingShow star ratings on the cards. It reads the rating and rating count that your reviews app saves to the product.
Show the Score Beside the StarsAppears when ratings are on. Show the average score, for example 5.0, next to the stars.
Show the Review Count OnlyAppears when ratings are on. Show only the number of reviews, for example (3).
Star ColorAppears when ratings are on. Choose the color of the filled stars. Leave it empty to use the theme’s accent color.
Empty Star ColorAppears when ratings are on. Choose the color of the unfilled part of the rating. Leave it empty for a faint tint of the text color.
Text ColorAppears when ratings are on. Choose the color of the score and review count. Leave it empty to follow the surrounding text color.

Settings — Quick View

SettingsDescription
Enable Quick ViewAdd a quick view button that opens the product’s details in a panel, without leaving the page.
Button DisplayChoose when the quick view button shows: On hover, Always, On hover, always on mobile or On hover, hidden on mobile.
Color SchemeSelect the color scheme for the quick view panel.
Quick View WidthSet the width of the quick view panel (720–1280 px).
Image Column WidthSet the width of the image column in the panel (280–640 px).
Space Between ColumnsAdjust the gap between the image and the details (16–96 px).
Inner PaddingAdjust the spacing inside the panel (16–64 px).
Corner RadiusCustomize the rounded corners of the panel (0–40 px).

Tip: What the quick view shows (its blocks and their settings) is edited on the Products › quickview template in the theme editor.

Settings — Promotional Tagline

SettingsDescription
Show Promotional TaglineScroll a short promotional message, such as LIMITED-TIME OFFER, across the bottom of the card image. It reads the theme.tagline product metafield. A product with a tagline shows it instead of the offer countdown.
Scroll SpeedChoose how fast the tagline moves: Slow, Medium, Fast or Very fast.
Color SchemeSelect the color scheme of the tagline strip.

Settings — Variants

SettingsDescription
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 SwatchesShow the color swatches on the cards. Customers can click a swatch to change the card image.

Settings — Cutline

SettingsDescription
Show CutlineShow a short line of text above the product title. It reads the theme.cutline product metafield.
Cutline ColorChoose the color of the cutline text.

Settings — Media

SettingsDescription
Show Second Image on HoverShow the product’s second image when a customer hovers over the card. Products with only one image keep the featured image.
Play a Second Video on HoverAppears when the second image on hover is on. When the product’s second media is a video, play it on hover instead of a still image. Nothing loads until the customer hovers, so page speed is not affected.

Settings — Quick Add

SettingsDescription
Show the Add ButtonShow a button that adds the product to the cart straight from the card. If an option, such as size, still needs choosing, the button opens quick view instead.
Button StyleAppears when the add button is on. Choose Plus, Cart icon or Add to cart text.

Settings — Size Panel

The size panel opens over the picture on hover, so customers can pick a size quickly. Which option it shows is set in Theme settings → Swatches → Single variation option.

SettingsDescription
Values to ShowSet how many option values (for example sizes) the panel shows (2–10).
Show the Chosen Value Beside the LabelShow the selected value next to the option name, for example Size: M.
Show the VendorShow the vendor as Brand: … opposite the option label.

Settings — Offer Countdown

SettingsDescription
Show an Offer CountdownShow a strip across the bottom of the picture that counts down to a deadline. Only products with a deadline metafield show it, and a product with a promotional tagline shows the tagline instead.
Deadline MetafieldEnter the 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 one that has passed, show no countdown.
Text Before the ClockAdd text shown before the countdown, for example Offer ends in.
Text After the ClockAdd text shown after the countdown.
Count Days as Well as HoursShow days in the countdown, not just hours, minutes and seconds.
Scroll the StripScroll the countdown strip, so a long message stays readable on a narrow card.
Scroll SpeedAppears when Scroll the strip is on. Set how fast the strip moves (10–100%).
Color SchemeSelect the color scheme of the countdown strip.

Settings — List View Card

SettingsDescription
Thumbnails Beside the PictureSet how many small thumbnails show down the side of the card in the collection page’s list view (0–6). Set it to 0 to hide them.

Product Card Block (Section Override)

Overview

Most product sections, such as Featured collection, Featured collection pills and Spotlight products, have a Product card block inside them. It changes the cards in that section only, so you can, for example, hide ratings in one carousel while keeping them everywhere else. Anything left on Same as theme settings follows Theme settings → Product cards.

How to use

  1. Go to Online Store → Themes → Customize.
  2. Expand the section, for example Featured collection, and select Product card.
  3. Leave a setting on Same as theme settings to follow the theme, or choose Show, Hide or another ratio to override it in this section.
  4. Click Save.

Settings

SettingsDescription
Image RatioSet the shape of the product images in this section. Options include Same as theme settings, Portrait, Portrait (5:4), Portrait (4:3), Portrait (2:3), Square, Landscape (3:2), Landscape (16:9) and Original.
Show VendorShow or hide the vendor on the cards in this section: Same as theme settings, Show or Hide.
Show Product RatingShow or hide the star rating on the cards in this section: Same as theme settings, Show or Hide. Ratings need a product reviews app.
Show Variant SwatchesShow or hide the color swatches on the cards in this section: Same as theme settings, Show or Hide.
Show the Add ButtonShow or hide the quick add button on the cards in this section: Same as theme settings, Show or Hide.
Was this helpful?
Previous Page banner Next Search drawer