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
- In the theme editor, click Theme settings (the gear icon).
- Open Product cards.
- Set the Layout options: image ratio, corner radius, text alignment and color scheme.
- Turn on the features you want, such as Show product rating, Show quick view, Show the add button or Show an offer countdown.
- Click Save. Every product card in your store updates.
Settings
| Settings | Description |
|---|---|
| Layout | The basic look of every product card. |
| Image ratio | The 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 radius | Rounds the card corners (0–40 px, in steps of 2). Default: 16 px. |
| Text alignment | Aligns the card text: Left, Center or Right. Default: Left. |
| Keep the collection in the product link | When 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 scheme | The color scheme of the cards. Default: Scheme 3. |
| Match the image to the active filter | When shoppers filter by a variant option such as color, each card shows the image of the matching variant. Off by default. |
| Show vendor | Shows the product vendor on the card. Off by default. |
| Reviews | Star ratings on the card. |
| Show product rating | Shows 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 stars | Shows 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 only | Shows only the number of reviews instead of the score. Off by default. Appears when Show product rating is on. |
| Star color | The color of the filled stars. Leave empty to use the theme’s accent color. Appears when Show product rating is on. |
| Empty star color | The 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 color | The color of the score and review count. Leave empty to follow the surrounding text color. Appears when Show product rating is on. |
| Quick view | A popup that lets shoppers see product details and add to cart without leaving the page. |
| Show quick view | Adds a quick view button to product cards. On by default. |
| Button display | When 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 scheme | The color scheme of the quick view panel. Default: Scheme 1. Appears when Show quick view is on. |
| Quick view width | The 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 width | The 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 columns | The 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 padding | The space inside the panel edges (16–64 px, in steps of 4). Default: 32 px. Appears when Show quick view is on. |
| Corner radius | Rounds the panel corners (0–40 px). Default: 20 px. Appears when Show quick view is on. |
| Promotional tagline | A scrolling message strip on the card. |
| Show promotional tagline | Reads 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 speed | How fast the tagline scrolls: Slow, Medium, Fast or Very fast. Default: Medium. Appears when Show promotional tagline is on. |
| Color scheme | The color scheme of the tagline strip. Default: Scheme 4. Appears when Show promotional tagline is on. |
| Variants | How product options show on the card. |
| Show sibling products | Off 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 swatches | Shows color swatches for the product’s variants on the card. On by default. |
| Cutline | A short line of text above the product title. |
| Show cutline | Reads the theme.cutline product metafield and shows it above the product title. On by default. |
| Cutline color | The cutline text color. Leave empty to use the scheme’s text color. |
| Media | What the card shows on hover. |
| Show second image on hover | Shows 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 hover | If 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 add | A button that adds products to the cart straight from the card. |
| Show the add button | Products 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 style | How the button looks: Plus, Cart icon or Add to cart text. Default: Plus. Appears when Show the add button is on. |
| Size panel | The 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 show | The maximum number of option values shown in the panel (2–10). Default: 6. |
| Show the chosen value beside the label | Shows the selected value next to the option name (for example, “Size: M”). On by default. |
| Show the vendor | Shows the vendor as “Brand: …” opposite the option label. On by default. |
| Offer countdown | A countdown strip across the bottom of the card image. |
| Show an offer countdown | Shows 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 metafield | 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 a deadline that has passed, show no countdown. Appears when Show an offer countdown is on. |
| Text before the clock | Text shown before the timer. Default: “Offer ends in”. Appears when Show an offer countdown is on. |
| Text after the clock | Optional text shown after the timer. Appears when Show an offer countdown is on. |
| Count days as well as hours | Shows 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 strip | Scrolls the countdown strip so a long message stays readable on narrow cards. On by default. Appears when Show an offer countdown is on. |
| Scroll speed | How fast the strip scrolls (10–100%, in steps of 5). Default: 40%. Appears when Scroll the strip is on. |
| Color scheme | The color scheme of the countdown strip. Default: Scheme 4. Appears when Show an offer countdown is on. |
| List view card | Settings for the row-style card in the collection list view. |
| Thumbnails beside the picture | The 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.