Help

Watch the 48-second setup, or find your question below.

How do I set up a free gift?

In the app, click Create rule. Give it a name, enter the cart total that unlocks the gift, choose the gift product variant, and save. Gratis creates an automatic discount for the gift. Then open your theme editor, go to App embeds, and turn on "Gratis free gift".

The gift isn't being added.

Check that the app embed is on in the theme editor (Theme settings › App embeds), the rule is Active, and the gift product is published to your Online Store with stock available. On the Free plan, gifts pause after 50 gifts in a calendar month. Gift cards, draft products and archived products can't be free gifts. If the app home says "Gratis can't find the Shopify discount for a rule", the rule's discount was removed from Shopify Discounts: delete the rule in Gratis and create it again.

How do I show the progress bar?

In the theme editor, add the "Free gift progress" app block to your cart page or cart drawer section. You can change the wording and colours in the block settings.

A shopper removed the gift. Why doesn't it come back?

If a shopper removes the gift on purpose, Gratis doesn't add it again during that browser session. It comes back in a new session, or after the shopper empties the cart and fills it again, if the cart still qualifies.

Which cart amount does Gratis compare with the rule?

The cart total after all discounts, before shipping. Gift items don't count. If another discount takes the cart below the amount, Gratis doesn't add the gift. A discount code entered at checkout doesn't remove a gift that is already in the cart.

What do the tiers do?

Each tier is a higher cart total with its own gift. When the cart reaches a higher tier, the lower gift is replaced by the higher one. The Free plan has one tier per rule; Pro has three.

Does it work with discount codes and other automatic discounts?

Yes, if the other discount also combines. The gift discount combines with product, order and shipping discounts, but Shopify also checks the other discount. If it doesn't combine with product discounts, Shopify applies only the larger one, and Gratis removes the gift from the cart when it stays at full price. Gratis checks the cart, not checkout. If a buyer enters a discount code at checkout, or goes to checkout while Gratis is still checking the cart, the gift can stay at full price there. To fix this, open the other discount in Shopify admin, turn on Product discounts under Combinations, and test carts with one, two and three items. A gift can count toward a discount's minimum item count, so a buyer with two items and a gift can get a three-item discount. If that happens, limit the discount to products or collections without the gift. The app home lists automatic discounts that don't combine, with a link to each one; a listed discount only blocks a gift when it applies to that cart. When gifts were removed in the last 7 days, the app home also lists discount codes that don't combine. A code only blocks a gift when a buyer enters it. After Gratis removes a gift that stayed at full price, it doesn't add that gift to the same cart again for 24 hours, unless the cart's discounts change, for example the buyer removes a discount code or switches currency. Then Gratis tries the gift once more.

I use a bundle or volume discount app. Why doesn't the gift stay free?

Bundle, volume and quantity break apps create their own Shopify discounts. If that discount doesn't combine with product discounts, Shopify applies only the larger discount to a cart that gets both. The bundle discount is often larger, so the gift shows its full price and Gratis removes it. To fix this, open Shopify admin › Discounts, open the bundle app's discount, and turn on Product discounts under Combinations. Some apps set combinations in their own settings instead. Then test a cart with a bundle and the gift.

Why did Gratis remove a free gift from a cart?

Shopify can count a free gift toward another discount's minimum item count. For example, two items and a gift can reach a three-item discount, so the buyer pays less than you planned. Gratis compares the amount due before and after it adds a gift. If the amount drops, Gratis removes the gift from that cart. The buyer keeps the normal discount but doesn't get the gift. This check is on by default. To let these buyers keep the gift, limit the other discount to products or collections without the gift. To keep the gift without changing the discount, turn off "Remove a gift that raises another discount" on the app home; buyers can then get the larger discount. This setting doesn't change what happens to a gift that another discount keeps at full price: Gratis always removes it from the cart. When a buyer changes the items in a cart that has another discount, Gratis can take the gift out and add it back to check the new cart, so the gift can disappear for a moment. The check runs on your online store theme.

Can I trigger a Shopify Flow workflow?

Yes. Use the "Gift threshold reached" trigger in Flow. It carries the rule name, the gift and the tier threshold.

Which themes are supported?

The app embed works with any theme. The progress bar app block needs an Online Store 2.0 theme. Cart sections are refreshed automatically after a gift is added or removed.

Still stuck? Email leodev19lee@gmail.com — we answer the same day.