Troubleshooting Auto Add to Cart

Troubleshooting guide for the Auto Add to Cart / Free Gift With Purchase feature. For setup, see that article. For non-troubleshooting questions, see Auto Add to Cart FAQ.

The free gift is not being re-added after the customer removes it

If you're experiencing issues where the free gift is not being added back to the cart after the customer removes it — for example, "the product can only be added once; if I delete it, it cannot be added again" — check the following:

This is one of the most common points of confusion with Auto Add to Cart offers, especially for promotions like:

• Buy 3, Get 1 Free
• Buy X, Get Y
• Free gift with purchase

By default, when a customer manually removes an auto-added item from the cart, our app intentionally remembers that choice and will not automatically add the item back again during that session.

For example:

1. A customer adds 3 qualifying products to the cart
2. The free gift is automatically added
3. The customer manually removes the free gift
4. The customer still meets the promotion requirements

At this point, the app will NOT re-add the free gift unless the "Re-add items after manual removal" setting is enabled.

Refreshing the page, revisiting the cart, or navigating to another page will not restore the gift while this setting is disabled.

This behavior exists because many merchants requested the ability for customers to permanently dismiss auto-added items from their cart.

Behavior of the setting:

• Toggle OFF (default behavior)
• Customers can permanently remove the auto-added item during their session
• The app will not re-add it automatically

• Toggle ON
• The app will continue checking eligibility
• If the customer still qualifies for the offer, the item will be automatically re-added after refresh/navigation/cart updates

1. To allow the app to automatically restore removed free gifts, enable the "Re-add items after manual removal" setting:

Theme Editor → App embeds → Add to Cart Embed → Re-add items after manual removal. By default, this setting is off, which means the app will intentionally not re-add items that the customer has removed.

2. After enabling the toggle, test by adding qualifying products to the cart, waiting for the free gift to appear, removing the free gift, and then refreshing or navigating to another page. The gift should be re-added automatically.

The product is not being added to the cart automatically

This could mean either one of two things:

1. 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. Our app will automatically either update the cart display or refresh the page after adding items to/removing items from the cart. Also, our app will dispatch a regios-dopp:auto-add-to-cart:update event on the window 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.
2. 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.

If we delete the free gift from the cart and then trigger the discount again, it doesn't add the free gift

By default, this is intentional. Many customers asked us for a way to allow the customer to remove the auto-added gift from the cart.

https://regios-technologies-inc.canny.io/feature-requests/p/auto-remove-trigger-product-with-auto-add-to-cart

This commonly affects "3+1" promotions and other quantity-based free gift offers.

Example:

• Customer adds 3 products
• Free gift is auto-added
• Customer removes the free gift manually
• Customer still has 3 qualifying items in the cart

Merchants often expect the free gift to immediately return because the qualification conditions are still met. However, by default, the app treats the manual removal as intentional and suppresses re-adding the item again during that session.

To change this behavior, enable the "Re-add items after manual removal" toggle in the Add to Cart Embed settings.

This behavior is expected unless the "Re-add items after manual removal" setting is enabled in the Add to Cart Embed settings.

The page reloads after the gift item is added

That's not a glitch. The app intentionally reloads the page after adding the item to the cart, because:

• In Shopify, merely adding an item to the cart doesn't automatically update the cart's display of items.
• Every single theme has a completely different way of triggering the cart display to refresh.

This means that, if you want to avoid a reload, we would have to create dedicated integrations with every single theme, which is impossible. In specific popular themes, we have an integration with the cart to update the cart display without a reload. In all other themes, as a fallback, we refresh the page after adding items to the cart.

You can easily disable this behavior with the "Auto Refresh Page" toggle of the "Add to Cart Embed."

Your Feedback Matters

Your review helps keep this small business running. Please leave one on the Shopify App Store.

Updated on: 06/06/2026