How to add a free gift to an offer

A free gift is a product you add to a discount tier at 100% off. When a customer reaches that tier and adds the bundle, the gift drops into their cart automatically at no extra charge. This guide covers adding a gift, setting its quantity and label, controlling when it shows, and the two configuration mistakes that silently break gift offers.

Add a free gift to an offer

Free gifts are configured per offer (per tier), so first open the bundle and expand the tier you want the gift attached to. Inside that offer you will find a Free gifts section with the helper text "Add free products (100% off) to this offer".

1. In the offer, find the Free gifts section and click Add free gift.
2. A new gift row appears with a Select product badge. Click it to open the product picker.
3. Choose the gift product and select the specific variant or variants you want to give away. The row then shows the product title and a "1 variant selected" (or "N variants selected") summary.
4. Open the gift row to set its Quantity and Text (see below).
5. Save and republish the bundle so the change reaches checkout.

Set the gift quantity and text

Each gift row has two fields plus a visibility toggle.

• Quantity - how many units of the gift to include per tier. A quantity of 2 gives two of the gift each time the tier is fulfilled.
• Text - the label shown for the gift in the widget. It supports the {{product_title}} template variable, so you can write something like Free {{product_title}} and it renders with the gift's real product name on the storefront.

A free gift is always 100% off, so the customer sees it as "Free". You do not set a price or discount percentage on a gift; that is the difference between a gift and a paid cross-sell.

Show only when this offer is selected

Each gift has a Show only when this offer is selected toggle that controls when the gift card appears in the widget:

• On: the gift card is hidden until the customer actively selects this offer tier in the widget.
• Off: the gift is always visible regardless of which offer is selected.

Turn it on when the gift is a reward for picking a specific higher tier. Leave it off when you want the gift to advertise itself on every tier as an incentive to buy.

How many gifts you can add, and how the count scales

You can add up to 10 free gifts per offer. Once you reach 10, the Add free gift button stops appearing for that offer.

The quantity you set is per fulfillment of the tier, and the gift count scales with how many times the customer meets the threshold. If a "Buy 3 + gift" tier is fulfilled twice over (the customer buys 6), they get the gift quantity twice. Only complete fulfillments count: the threshold-met count is rounded down, so partial overflow units do not earn an extra gift. A customer at 7 units on a "Buy 3" tier still gets two gifts, not three.

Critical: a gift cannot be the same variant as the main product

This is the most common reason a gift offer "does nothing". A gift cannot be the same variant as the main product in the bundle. Shopify refuses a nested add that contains a free (zero-priced) line of the exact variant being discounted, and returns a 422 error. When that happens, Bundlex falls back to adding just the main product at full price, so the customer ends up with one item, no discount, and no gift.

If you want to give away another unit of the same product (for example, buy one get one free), do not use a free gift. Use a Buy X Get Y (BOGO) offer instead. Shopify accepts a BOGO on the same variant; it rejects a same-variant zero-priced gift line.

If a Buy N tier silently adds only one full-price item, check the gift's product and variant against the main product first. Matching variants are the cause.

Critical: gift products must be available on the storefront

The gift variant has to be purchasable on your storefront, or the whole bundle add fails the same way: a 422, then a fallback to one full-price item with no discount and no gift. Common culprits:

• The gift variant is out of stock with inventory tracking on. Either turn on Continue selling when out of stock for the gift product, or uncheck Track quantity.
• The gift's stock sits only at a location that does not fulfill online orders, which makes Shopify report the variant as unavailable even when quantity is on hand. Set that location to fulfill online orders, or move stock to one that does.
• The gift product is not published to the Online Store sales channel.

The gift product does not need to be listed or featured in your catalog; it can stay unlisted. It only needs to be available for purchase so Shopify will accept it as a cart line. A quick way to confirm is to load /variants/<variant-id>.js on your storefront and check that available is true.

Quick troubleshooting

• Tier adds only one item at full price, no gift: the gift is the same variant as the main product, or the gift variant is unavailable. Fix the variant choice or the availability, then republish.
• Add free gift button is missing: you have already added 10 gifts to that offer, the per-offer maximum.
• Gift card never shows in the widget: check the Show only when this offer is selected toggle; if it is on, the gift only appears once the customer picks that tier.
• Changes not live: save and republish the bundle, then test in a fresh session so an old storefront cart does not mask the change.