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 checking its product setup.

Keep a normal selling price on the gift variant in Shopify. Bundlex makes it free when the offer qualifies. A gift priced at 0.00 can be removed by gift cleanup because no discount was applied to it. See a gift that never adds or disappears after adding.

Add a free gift to an offer

1. Open the bundle's Offers tab and expand the offer.
2. Click the Free gift feature button at the bottom of the offer. The product picker opens.
3. Choose the gift product and its available variants. The Free gifts section appears after selection.
4. Open the gift row to set its Quantity and Text.
5. To add another gift, use the add control in the existing Free gifts section.
6. Save and make sure the bundle is published, then test it on the storefront.

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.

Gift quantity depends on how the offer is added and how the cart qualifies. Repeated complete offers can qualify for repeated gifts when the cap is off, but increasing a main product's cart quantity does not automatically add missing gift lines.

On eligible quantity offers using Bundlex's current Quantity selector, the gift is added once even if the shopper increases the item quantity. Complete product bundle sets include their configured gifts per set. See quantity selector behavior.

With the strict quantity cap on, an eligible discounting tier applies at most once. A single "Buy 3 + one gift" tier at quantity 6 gives 3 discounted main units and one gift, while the other 3 main units stay full price. Gifts from other, unselected tiers are not automatically added. See quantity caps and gifts.

Giving away more of the main product

For a promotion such as "Buy 2, get 1 free" on the main product, use a Buy X, get Y offer. Attached free gifts are suited to separate reward products.

A rejected cart request does not by itself prove that matching variants caused the problem. Bundlex can retry a rejected nested add without parent relationships, then retry the main products with their discount information if an extra remains unavailable. The result is not always one full-price item. Contact support with the product URL and the result you see if a gift still fails.

Critical: gift products must be available on the storefront

The gift variant has to be purchasable on your storefront. If Shopify rejects it, recovery may add the main products without the gift. Check these availability conditions:

• 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

• Main products add but the gift is missing: check gift availability and the qualifying quantity. If those are correct, contact support with the product URL and the steps that reproduce it.
• 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.

Rewarding bigger offers instead

The gifts described here are attached to one offer. If you would rather show a row of rewards that unlock as customers move up your tiers, with a progress tracker below the offers, use progressive gifts instead.