This help doc is to troubleshoot sold out errors that appear after clicking the add to cart button.
Not sure which issue you have? Start at Bundle shows as sold out or won't add to cart - start here.
This page also covers an Add to Cart button that is greyed out, faded, or that the app cannot detect. For a bundle that shows sold out on page load, see Bundle displaying sold out. For a red error message on the form, see Bundle form errors.
When you create a bundle inside the Biscuits Bundles app, a new bundle product is created in Shopify.
These errors may appear when trying to add this bundle product to cart.
Sometimes the bundle product may look as though it has added successfully depending on your theme, but nothing has been added to cart.
➡ Ensure you have added the Biscuits App Block to your theme before troubleshooting further.
How to add the Biscuits Bundles App Block to your theme
If you are seeing either of the following errors when adding your product to cart - please check the settings below:
The #{{ productName }} cannot be added to cart
The #{{ productName }} is already sold out
Cannot find variant
Active?
Online Store?Online Store sales channel.
Sometimes Shopify preview themes can be cached, or a little buggy. Try going to your product link directly:
For example, navigate directly to your product. The url should look similar to this:
https://biscuits-bundles-demo.myshopify.com/products/cupcake-12-pack
The link should not look like this:
https://56mzkn6a9z06fh4f-59994568057.shopifypreview.com/products_preview?preview_key=8d5f2207e5f80240da49956d7335e5a7
Biscuits Bundles works with most themes immediately, but some themes may have an incompatible Sticky Add To Cart.
If you've tried the above - double check if your theme is displaying a Sticky Add To Cart.
In the theme editor, turn your Sticky Add To Cart off
Save the changes
On your store front (not in the theme editor) - navigate to your-store.com/cart/clear
/cart/clear will clear your cart of any existing errors
Navigate to your bundle product and add it to cart again.
If it works, then the Sticky Add To Cart is not compatible with Biscuits.
You can then create a new product template in your theme editor and turn the Sticky Add To Cart off. You can then assign your bundle product to this new template.
Biscuits Bundles does not work with Quick Add to Cart Buttons, and some Quick Views.
Biscuits Bundle products require a form on a product page with component item selection to successfully add to cart.
Most quick add and quick view buttons on grid items don't allow for the display of this form and these selections.
> Use our app embed to adjust them here
When using a quick add to cart button on a product grid item (on the collection page, or in other sections) you'll see an error and the product will not add to cart.
You can resolve this by any of the following
Turning off Quick Add To Cart and/or Quick View in your theme editor for the whole theme
Make some code changes to selectively hide these buttons for only products tagged 'biscuits-bundles' using the guides linked below.
If you're not code savvy - reach out to us and we'll request collaborator access to make some changes to your theme.
How to hide bundle product quick add to cart buttons
Your bundle product grid items will display "Sold out" or an error message when trying to be added from quick add.
Sometimes, other apps installed on your store can interfere with how bundles are added to the cart.
Apps that handle extra product options, line item properties, or upsells often use their own add-to-cart code, which can override or interrupt the standard process.
Biscuits Bundles is designed to work with your theme’s default add-to-cart method, so if another app changes this process, it can stop bundle products and their selection data from being added to the cart correctly.
If you’re using an app that adds extra product options, please review the following help article to make sure you’ve enabled the correct setting:
How to enable line item properties to pass through onto bundle components
Rarely, Shopify’s cart can cache errors, causing products to fail to add to the cart even when they should.
If you’ve checked the inventory and other settings but are still encountering the error, you can clear the cached error by following these steps:
1. Navigate to your store’s URL with /cart/clear appended:
Example:
mystore.com/cart/clear
This URL will reset your cart programmatically, clearing any cached errors.
If the issue persists, please reach out to us and we'll assist.