1. What setup can you do in Product card?
The Product card setting in Theme Settings is where you control how every product card looks and behaves across your entire store- from the image ratio and hover effects, to sale labels, highlighted product attributes with optional icons, estimated delivery date, and the layout of the "Add to cart" button. Changes here apply globally to all product cards, giving you a consistent look across your collection pages, homepage sections, search results, and more.

2. Location & Setup
- Go to "Online Store" > "Themes" > "Customize".
- Click the Theme Settings tab (gear icon) on the left sidebar.
- Go to Product card.
3. Setting group overview
Take a look to see what you have within the Product card setting:
| Group name | Purpose |
|---|---|
| General (first group) | Control the core visual appearance of every product card: image ratio, container color, padding, hover effect, content alignment, and how inventory status is shown. |
| Sale labels | Show a customizable sale badge on discounted products. Control the label text and its colors for light and dark modes. |
| Highlight attributes | Show up to 5 product highlights- each with an optional icon and a text label- sourced from product metafields. Supports static display or auto-rotating animated format. |
| Estimated delivery date | Show a delivery estimate message on product cards, with an option to hide it for pre-order products. |
| Overlay | Configure the "Add to cart" button layout (hidden, on image, bottom of card, or with quantity selector), button style, and border visibility. |
| Style | Fine-tune the card's color palette: highlight color, heading, body text, price, sale price, and star rating- independently for light and dark modes. |
4. Common Use Cases
🤔 How to set up the overall product card appearance?
Want to customize how product cards look across your store? Follow these steps:
STEP 1: Go to Theme Settings > Product card.
STEP 2: Customize the general settings
In the first setting group:
- Select a Product image ratio and Container color for both light and dark modes.
- Drag to adjust the side padding (0–20px) for desktop and mobile.
- Turn on "Show border" to add a border for the card.
- Choose an Effect on mouse hover and Content alignment.
- Choose how inventory statuses are displayed on the card.
STEP 3: Customize how the "Add to cart" & "Choose option" buttons look
Scroll down to the Overlay setting group:
- Choose the layout of the "Add to cart" button on desktop and mobile:
- None
- On product image
- Bottom of product card
- Bottom of product card with quantity selector
- Change the Button label of both buttons if you don't like the default "Add to cart" and "Choose option" names.
- (Optional) Select the Button style to be Primary button or Secondary button.
- (Optional) Toggle on "Sticky buttons" to make the "Add to cart" and "Choose option" buttons align with the bottom of the product card.
STEP 4: Customize the colors of product cards
Scroll down to the Style setting group:
- Customize the color of Highlight, Heading, Text, Price, and Sale price for both light and dark modes.
- If a product rating app is used, also customize the Rating color.
STEP 5: Click "Save" when done.
🤔 How to display sale labels and/or estimated delivery date on product cards?
STEP 1: Go to Theme Settings > Product card.
STEP 2: Set up sale labels
In the Sale labels setting group:
- Enable Show sale label to display a badge on discounted products.
- Fill in the Sale label content (the text shown on the badge).
- Customize the Sale label background and Sale label text color for both light and dark modes.
STEP 3: Set up Estimated Delivery Date (EDT)
In the Estimated delivery date group:
- Enable Show estimated delivery date.
- Fill in the Message field with the delivery estimate text shown to customers.
- To hide the EDT for pre-order products, enable Hide when Pre-order is enabled.
STEP 4: Click "Save" when done.
🤔 How to show highlighted attributes (icons/image) with label (tooltips) on product cards?
The Highlight attributes setting lets you display up to 3 product feature highlights on each product card - each with an optional icon and a text label sourced from product metafields.

a) Method 1: Using icons from Maximize's icon library
Use this method if you want to display one of Maximize's built-in icons next to each product feature.
Step 1: Create a product metafield for the icon name.
- Go to Settings > Metafields and metaobjects > Products > Add definition.
- Name the metafield (e.g., "Feature icon 1").
- Set the Type as Single line text – One value.
- Save the metafield.
Step 2: Assign the icon name to each product.
- Go to Products > open a product > scroll to Metafields.
- Click the metafield you just created and enter the name of the icon from Maximize's icon library.
Step 3: Connect the metafield in Theme Settings.
- Go to Theme Settings > Product card > Highlight attributes.
- In the Icon metafield 1 field, enter the metafield's Namespace and key (e.g.,
custom.feature_icon_1).
Step 4: Click Save.
Repeat Steps 1–4 for up to 3 icons using Icon metafield 2 and Icon metafield 3.
⚠️ Note: If you enter a name not found in the icon library, it will be displayed as plain text instead of an icon.
b) Method 2: Using custom images as icons
Use this method if you want to upload your own image files as product card icons.
Step 1: Create a product metafield of type (Image) File.
- Go to Settings > Custom data > Products > Add definition.
- Name the metafield (e.g., "Feature image icon 1").
- Set the Type as (Image) File.
- Save the metafield.
Step 2: Upload an image to each product.
- Go to Products > open a product > scroll to Metafields.
- Click your metafield and upload the custom icon image.
Step 3: Connect the metafield in Theme Settings.
- Go to Theme Settings > Product card > Highlight attributes.
- Enter the metafield's Namespace and key into the corresponding Icon metafield field (e.g.,
custom.feature_image_1).
Step 4: Click Save.
⚠️ Note: If you enter the same Namespace and key into multiple Icon metafield fields, the icon will only appear once on the card.
c) Adding tooltips (label metafield)
💡 By default, your configured label metafield inside the Highlight attribute setting group will be shown as a tooltip - a small pop-up that appears when customers hover over the icon. This keeps the card clean while still providing information on demand.

Step 1: Create a product metafield for the label text.
- Go to Settings > Metafields and metaobjects > Products > Add definition.
- Name it (e.g., "Feature label 1").
- Set the Type as Single line text.
- Save the metafield.
Step 2: Assign the tooltip text to each product.
- Go to Products > open a product > scroll to Metafields.
- Click the label metafield and enter the tooltip text customers will see when hovering over the icon.
Step 3: Connect the metafield in Theme Settings.
- Go to Theme Settings > Product card > Highlight attributes.
- Enter the metafield's Namespace and key into the corresponding Label metafield field (e.g.,
custom.feature_label_1).
Step 4: Click Save.
⚠️ Note: You can reuse the same label metafield across multiple icon slots by entering the same Namespace and key in different Label metafield boxes.
d) Where do highlight attributes appear?
By default, highlight attributes appear on all product cards in the following sections:
- Featured collections
- Product bundle
- Promotion grid
- Promotional collections
- Recently viewed products
- Collection page > Product grid
- Search page
- Product recommendations
- Cart page (Cart upsell)
✍️ If you want to hide highlight attributes in a specific section, go to that section in the Theme Editor and turn off the "Show highlight attributes" toggle.
🤔 How to show 1 highlight attribute at 1 time? New in v1.5.0
By default, all configured highlight attributes are displayed simultaneously- each on its own line below the product card. The auto-rotate feature changes this: instead of showing all attributes at once, it displays one attribute at a time and automatically cycles through the rest, keeping the card compact and visually engaging.

STEP 1: Go to Theme Settings > Product card > Highlight attributes.
STEP 2: Make sure you have already set up your Icon and/or Label metafields (see the previous use case above).
STEP 3: Toggle Enable auto-rotate ON.
STEP 4: Choose your Animation style:
- Fade (default)- The current attribute fades out and the next fades in.
- Slide- Attributes slide in from right to left.
- Rise- Attributes rise upward as they transition.
STEP 5: Set the Auto-rotate every interval (1–10 seconds, default: 3s)- this controls how long each attribute is shown before rotating to the next.
STEP 6: (Optional) Toggle Show background ON to add a subtle background fill behind the rotating attribute.
STEP 7: (Optional) Set custom Text color (light) and Text color (dark) for the attribute text. Leaving these as Transparent inherits the theme's default text color.
STEP 8: Click "Save" when done.
⚠️ Notes:
- The rotation order follows the metafield slot order: metafield 1 → 2 → 3, then loops back to 1.
- When auto-rotate is ON, if a highlight has both an icon and a label, both are visible together. The label is no longer hidden - it shows next to the icon. Hovering still shows the label as a tooltip.
- If a label text is too long to fit on one line, it is truncated with "..." and the full text is shown on hover.
- If a highlight slot has no metafield value assigned for a product, it is simply skipped in the rotation.
🤔 How to add and customize different types of labels and badges on product cards?
Please follow this guide: Product labels and badges
5. Change Logs
Version 1.5.0:
- Theme setting Product card: options to edit 'Add to cart' button label have been added to the 'Overlay' group.
- Highlight attributes can now be displayed as auto-rotated text and icon. Icon metafield now also accepts image-type metafields in addition to single line text.
Version 1.3.0:
- 'Product card' group: the quantity selector and 'Add to cart' button can now be displayed on the product card.
6. Support Information
Need help? Contact our support team at Omni Themes Support