Cart rewards and free gifts

The reward programme is configured in two places.

The spend thresholds and the encouragement copy live in Theme settings under Rewards Tiers. Four tiers are supported.

The gift products themselves live in Shopify Admin as metaobjects. The cart reads them at render time, so adding a gift does not need a developer.

Change a spend threshold or its copy

1. Open Shopify Admin, then Online Store, then Themes.
2. Click Customize on the live theme.
3. Open Theme settings from the bottom of the left sidebar.
4. Open the Rewards Tiers group.
5. Edit the tier you need. Each tier has these fields:

6. Save.

The encouragement messages accept two placeholders. The cart replaces {remaining_amount} with the spend still needed, and {threshold_money} with the tier threshold in store currency. Type them exactly, including the braces.

Leave Price Threshold empty to switch a tier off. The cart skips any tier without a threshold.

Change which products are the free gifts

Gifts come from the minicart_free_gifts metaobject, not from theme settings.

1. Open Shopify Admin, then Content, then Metaobjects.
2. Open the minicart_free_gifts type.
3. Edit or add an entry.

4. Save.

When gift_type is Collection, the cart takes the first product in that collection. Reorder the collection in Shopify Admin to change which product customers get.

The progress bar matches a gift to a tier by comparing price_threshold against the tier's Price Threshold setting. The two numbers must be identical. A gift at 150 will not attach to a tier set at 149, and the tier then falls back to its Title in cart.

short_title accepts one placeholder. The cart replaces {category} with the gift product's Shopify category. Type it exactly, including the braces.

Change cart drawer copy

The drawer is made of theme blocks, and each block holds the copy it renders.

1. In the theme editor, open any page.
2. Find the Mini cart section in the left sidebar.
3. Select the block you want to edit.

The Mini cart section also has two section-level settings. Open when item is added controls whether the drawer opens automatically after an add to cart. Max drawer width sets the desktop width in pixels, and the drawer is always full width on mobile.

Business rules

Free gift lines are excluded from the reward subtotal. A line carrying the __free_gift property does not count towards unlocking the next tier, so a customer cannot chain gifts into further gifts.

Carts containing a MediSpa item hide the progress bar entirely. The rule matches any line whose vendor name contains medispa, so a treatment booking will never show a beauty-product reward prompt.

The progress bar and the gift compare against the threshold differently. The progress bar unlocks a tier when the subtotal is strictly above the threshold, so a cart at exactly 150 does not unlock a tier set at 150. The cart adds the gift when the subtotal reaches the threshold. Set thresholds a dollar below the round number you want customers to hit, or accept that the bar fills one cent late.

The theme displays a threshold of 198 as 199 wherever the tier appears. This override is hard-coded and predates these docs. Avoid 198 as a threshold value.

Gift eligibility converts the cart total into the shop's base currency before comparing. A customer shopping in NZD is measured against the same AUD threshold as everyone else.

Verify the change

1. Open the storefront in a private window.
2. Add a product priced below your lowest threshold. The progress bar should name the first tier and the remaining spend.
3. Raise the quantity until you cross the threshold. The bar should fill and the gift should appear in the gifts accordion.
4. Check the homepage Free Gifts Banner and Unlock Free Bonus sections show the same thresholds.

If the drawer does not update, follow Cart total or gift is wrong.

Developer map

Architecture behind the drawer is in Mini-cart.