Auto Add to Cart/Free Gift With Purchase

Our app now supports creating "auto add to cart" offers, where 1 or more product variants are automatically added at checkout when specific conditions are met.

Use Cases

Offering a free gift with purchase (ex. Spend $300 or more, get this item for free)
Automatically adding "shipping protection," "purchase protection," or similar warranties to the cart

How it works

Similarly to discounts, you will use the advanced logic builder to create these types of offers.

Instead of adding "Apply discount" steps at the end, though, you will add "Add to cart" steps.

The "Auto add to cart" works via two parts:

JavaScript that continually checks the customer's cart to see if they're eligible for an automatically added product, and if so, adds it.
A Shopify Functions discount that applies a discount to those products, only if the conditions from their logic are met. This makes it more secure and prevents the wrong people from receiving discounts.

Setup

Click "Create discount," then click "Auto add to cart."



Enter a title for your offer, and create logic for when products should be added to the cart, using our advanced logic builder.



Lastly, enable the "Add to Cart Embed" and the "Discounts Embed" in the Theme Editor. This will handle actually adding products to the cart.

Limitations of auto add to cart offers

Because these require JS to actually add the product to the cart, they currently have some limitations:

It does not work in the POS
It does not work in draft orders/manual orders
The customer must visit at least one page in the Online Store before reaching the checkout
Auto add to cart is always an automatic discount, and cannot be a manually entered discount code.

As we continue development of this feature, we will try to work around these API limitations.

Can auto add to cart offers combine with other discounts?

Yes. They combine with product, order, and shipping discounts. If you would like to be able to change this, please reach out to us.

Can the cart drawer refresh when items are added/removed?

Unfortunately, this is nearly impossible right now, as it would require us to create dedicated integrations with every single theme and cart drawer app on Earth. We just don't have the bandwidth for this right now. The best workaround right now: Our app will dispatch a regios-dopp:auto-add-to-cart:update event after adding/removing items to/from the cart. We recommend adding custom code to your cart to listen for this event and trigger a reload of the cart/cart drawer section on your site. For more information, please read this closed thread in our public feedback board.

Troubleshooting Auto Add to Cart

The product is not being added to the cart automatically

This could mean either one of two things:
The product is getting added to the cart (and you can see it in checkout), but you're expecting the cart drawer/cart page to refresh automatically. Unfortunately, this is nearly impossible, as it would require us to create dedicated integrations with every single theme and cart drawer app on Earth. The best workaround right now: Our app will dispatch a regios-dopp:auto-add-to-cart:update event after adding/removing items to/from the cart. We recommend adding custom code to your cart to listen for this event and trigger a reload of the cart/cart drawer section on your site. For more information, please read this closed thread in our public feedback board.
OR, the product is not getting added to the cart at all, and you don't see it even when you go to the checkout. If so, keep reading.

If you are noticing the product is not being added to the cart automatically, make sure it is published to the Online Store sales channel first.
Make sure the product variant is in stock, or that it has "Keep selling when out of stock" enabled.
If this still doesn't fix the issue, please contact support.

I am seeing unexpected text on packing slips

You might be seeing text such as regios auto add to cart node id or regios auto added by discount id on your packing slips.

We want to clarify that our app doesn't directly modify packing slips at all. What you're seeing is related to line item properties, which are necessary for the "Add to Cart" discount to function properly.

These properties are created as "private properties," meaning they should not be visible in the Online Store (though they will be visible on the "Orders" page in the backend, with underscores at the start of their names). If they are showing up on your packing slips, we recommend contacting the support team for the app that generates your packing slips (for example, ShipStation) for clarification on why these private properties are appearing on customer-facing surfaces.

For more information on private properties and attributes, you can check this Shopify documentation.

Updated on: 20/02/2025