> ## 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.

# Cart rewards

> Encourage larger carts with shipping, percentage discount, and free gift goals.

Show shoppers how close they are to a reward in the cart drawer and on the cart page. You can create up to four tiers in **Settings** → **Cart rewards**.

## Set up your goals

**1. Add a tier**

Click **Add reward tier** and choose **Free shipping**, **Percentage off**, or **Free gift**.
For a gift, click **Choose gift variant** and select exactly one variant. Remove the selected tag to clear it, or use the picker to replace it.
Keep the gift in stock and published to the Online Store in every country where you offer it.

**2. Set currency and country thresholds**

Enter thresholds such as `USD=50, CAD:CA=70`. Amounts use the named currency, so `USD=50` means US$50.
        A country-specific threshold overrides the currency threshold. For example, `USD=50, USD:US=60` uses US$60 in the United States and US\$50 elsewhere.
Add each currency your store accepts. Rewards stay hidden and do not apply in currencies without a matching threshold.

**3. Choose what counts**

Choose **Cart total** or **Item count**. Item thresholds must be whole numbers.
**Count totals before product discounts** is enabled by default. Gifts and excluded products never count.
Use **Choose excluded products** and **Choose excluded collections** to omit products from both progress and percentage rewards. You can select up to 100 of each. Remove a selected tag to include that item again.
Collection changes can take up to a minute to appear in the bar.

**4. Enable rewards and save**

Select **Enable cart rewards**, then click **Save** in the save bar.
Your settings become active after Shopify accepts the discount. A failed save keeps your previous settings.
In your theme editor, turn on the **Appfox Bundles** app embed and save your theme.

## How rewards combine

The highest unlocked percentage applies to eligible products. Percentage tiers do not add together.
Shipping and gift rewards combine with that percentage. Each gift tier adds one free unit and removes it when the cart drops below its goal. Gift prices never help unlock another tier.
Free shipping covers all delivery groups. Other discounts must allow combination with the relevant product, order, or shipping discount for Shopify to combine them.

> [!NOTE]
>
> Shopify evaluates discount functions independently. Use totals before product discounts for consistent goals when you also offer bundle or third-party discounts.
> Turning this option off uses the line totals Shopify makes available when evaluating rewards; it cannot account for discounts calculated concurrently by another function. Order discounts do not reduce qualifying totals.

## Customize the bar

The bar inherits your colors, spacing, corner radius, and font from **Settings** → **Design**.
You can add rules for `.appfox-cart-rewards` in **Settings** → **Custom CSS**.
Translate the progress message, reward labels, completion message, and gift error in **Settings** → **Translations**.

## Measure reward orders

Open **Analytics** to see **Cart reward orders** for the selected date range. Each order counts once per unlocked tier, even if Shopify retries the order notification. The table identifies tiers by their saved tier ID. It uses the settings shown by the cart widget and the products on your completed orders. The cart widget must load before checkout for an order to be attributed; a shopper reaching a goal without placing an order does not count. Changing or removing a tier does not change attribution for a cart that already saw it.

## Troubleshooting

If the bar is missing, check that rewards and the app embed are enabled, your cart contains a paid product, and you entered a threshold for the cart currency.
The bar supports Dawn, Horizon, and drawers using standard cart drawer containers.

If a gift cannot be added, the bar shows an error. Check its inventory, publication, variant ID, and market availability. Updating the cart retries the gift.
If you change the cart after entering checkout, return to the storefront cart so the widget can add or remove gifts. Shopify still checks gift eligibility at checkout; an ineligible gift receives no reward discount.

> [!TIP]
>
> Pair rewards with a bundle cart upsell to give shoppers a useful item to add toward their next goal.


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