> ## Documentation Index
> Fetch the complete documentation index at: https://bundles-docs.getappfox.com/product-bundles/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Product card badges

> Show a Bundle & save badge on product cards in collections, search results and homepage grids for products that have a bundle or volume offer.

The **Product card badges** app embed puts a small badge on your product cards, such as **Bundle & save up to 20%** or **Buy 2, save 10%**. Shoppers see the deal on collection pages, search results and homepage product grids before they open the product.

## Turn on the badges

**1. Open the theme editor**

Go to **Online Store** → **Themes** in your Shopify admin and click **Customize** on your active theme.

**2. Enable the app embed**

Open **Theme settings** → **App embeds**, find **Product card badges** and toggle it on.

**3. Save your changes**

Click **Save** in the top right corner.

## Which products get a badge

A product gets a badge when an **active** bundle covers it. Bundles that are paused, or outside their schedule, don't show a badge.

The badge shows the best saving the shopper can get on that product:

| Offer | Badge |
| - | - |
| A volume bundle with one percentage tier | **Buy 3, save 15%** |
| Several percentage tiers, or a fixed bundle with a percentage | **Bundle & save up to 20%** |
| A flat amount, fixed price, free gift or buy X get Y offer | **Bundle & save** |

Bundles limited to new or returning customers, to customer tags, or that exclude B2B buyers don't produce a badge, because not every shopper gets the deal.

## Customize the badge

Open the embed's settings in the theme editor:

* **Badge position**: top left, top right, bottom left or bottom right of the product image.
* **Custom badge text**: replaces the default wording. Use `{percent}` for the saving and `{count}` for the quantity. If a deal doesn't have the number your text asks for, the default wording is used for that product.
* **Product card CSS selector**: only needed if your theme isn't Dawn or Horizon. Enter a selector that matches each product card, for example `.product-tile`.

**Colors**: the badge uses the **Badge background** and **Badge text** colors from **Settings** → **Design**.

**Languages**: the default wording is translated into the languages in [Supported languages](https://bundles-docs.getappfox.com/product-bundles/docs/settings/supported-languages.md). To change the wording for a language, go to **Settings** → **Translations**, choose **Widget text (all bundles)**, and edit the fields labeled **Bundle & save up to {percent}%**, **Buy {count}, save {percent}%** and **Bundle & save**.

> [!NOTE]
>
> The badge sits on top of the product image, so it never moves the rest of your layout. Badges refresh when a theme filters, sorts or loads more products without reloading the page.

> [!TIP]
>
> Want to see which bundles earn a badge? Check that they are **Active** in **Bundles**, then open a collection page. Need help? Contact us at [support@getappfox.com](mailto:support@getappfox.com).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.