Troubleshooting bundles not breaking down at checkout

Running into issues with your bundle content not displaying correctly during checkout using Simple Bundles version 2.0?

Here's a quick guide to troubleshoot and solve common problems:

1. Empty bundle inside another bundle
2. Cart drawer or theme compatibility
3. Bundle options not linked to products
4. App block or embed system issues (Infinite options bundle)
5. Empty option name (Infinite options bundle)
6. Double quotes in option names (Infinite options bundle)
7. Nested bundle level exceeds 10
8. Quick view or quick add to cart outside product page (Infinite options bundle)
9. Recent migration to Simple Bundles V2.0 with manual installation
10. The cart transform function is not running.

Understanding the root cause is key to finding the right solution, as each scenario requires a different approach. In this article, we'll walk you through the most common causes and what you can do to resolve each one.

Empty bundle inside another bundle

If you're trying to create a nested bundle, ensure that each level contains its bundle content. To ensure nested bundles (a bundle within another bundle) display correctly:

1. Open the bundle and select a product.
2. In the Shopify product dashboard, choose "More actions" > "Edit bundle" via Simple Bundle.
3. If it's a bundle, it will open in the Simple Bundle dashboard. Ensure it's not empty.

Cart drawer or theme compatibility

Certain theme developers or third-party cart drawer apps may not add properties to the cart during the POST method execution, preventing proper breakdown. Follow our technical guide for step-by-step instructions.

Bundle options not linked to products

If a bundle option is missing assigned products, the dropdown selections in your Infinite Options bundle may appear greyed out and show as out of stock. In some cases, the dropdown may still be selectable, but the bundle will not break down correctly at checkout. This typically occurs when an option was created, but no products were assigned to it behind the scenes.

You will also see a warning banner within your bundle details page indicating that some bundle items are no longer properly connected. Click on Switch to Manual Build from the yellow banner to go directly to bundle configuration.

To fix:

1. Click Switch to Manual Build from the yellow banner to go directly to your bundle configuration or switch directly to the manual build method.
2. Review each option; Look through each option with missing products
3. Add the appropriate products to the affected options.
4. Click Save to apply the changes.

App block or embed system issues (Infinite options bundle)

Ensure the app block or embed system is rendered inside a <form>     element in the HTML structure of your theme. Test by enabling only the app block or embed system separately.

Empty option name (Infinite options bundle)

Ensure option names are assigned, as they are crucial when products are added to the cart.

Double quotes in option names (Infinite options bundle)

Avoid using double quotes in option names, as they can disrupt the rendering process. Instead, use single quotes or other alternatives to prevent interference with the HTML attributes.

Example of use with double quotes:

Rendered attributes:

Nested bundle level exceeds 10

Avoid creating bundles with more than 10 levels. If you surpass this limit, the bundle content will only break down to the 10th level.

Quick view or quick add to cart outside product page (Infinite options bundle)

If you are using Quick View or Quick add to cart buttons, make sure to omit the infinite options bundle, since drop-downs are usually not shown in these sections and, as a result, the bundle can be added without options selected.

For more information, you may refer to this guide: Quick "Add to cart" and infinite option bundles: What you need to know

Recent migration to Simple Bundles V2.0 with manual installation

If you've recently migrated to version 2.0 and experience issues with your manual installation of infinite options bundle, follow these steps:

Paste the following code at the end of the "simple-bundles-options.liquid" file in your theme.

<script>
  (function() {
    // function to update the hidden input value
    function updateHiddenInputValue() {
        var selects = document.querySelectorAll('#{{ div_id }} select');
        var values = [];
        
        selects.forEach(function(select) {
            var selectedOption = select.options[select.selectedIndex];
            if (selectedOption) {
                values.push(selectedOption.value);
            }
        });
        
        if (values.length === 0) {
          return;
        }
        var hiddenInputValue = values.join(' <> ');
        var hiddenInput = document.querySelector('#{{ div_id }} input[name="properties[_bundle_selection]"]');
        if (!hiddenInput) {
            hiddenInput = document.createElement('input');
            hiddenInput.type = 'hidden';
            hiddenInput.name = 'properties[_bundle_selection]';
            document.getElementById('{{ div_id }}').appendChild(hiddenInput);
        }
        hiddenInput.value = hiddenInputValue;
    }
    // call the function initially to update the hidden input value
    window.addEventListener('pageshow', updateHiddenInputValue);
    // listen for changes on each select element and update the hidden input value
    var selects = document.querySelectorAll('#{{ div_id }} select');
    selects.forEach(function(select) {
        select.addEventListener('change', updateHiddenInputValue);
    });
  })();
</script>            

Bundle contents not included in any sales channels

If you don't want to sell your products individually in your store and have disabled the Online Store channel for the items, this can cause issues breaking down items at checkout. Instead, you can set the status to Draft and enable the Online Store channel.

The cart transform function is not running.

If the cart transform function does not run, it directly affects how bundles are broken down in the order. The cart transform function in Simple Bundles only works for orders processed through Shopify Checkout. If it isn't running, the order is likely coming from a channel that does not support Shopify Checkout, such as:

• Subscription orders (e.g., processed through subscription apps)
• Third-party sales channels (e.g., external marketplaces)
• Third-party apps importing orders from another source

Learn more Why aren't my bundles breaking down and how to solve it (V2.0)