General Troubleshooting
Why aren’t any products showing in the UI?
If no products appear in the UI, check the data source configuration. Some default endpoints may not yet contain product data. Ensure that the correct data source is selected and is actively syncing product information.
Why isn't my Bundle Builder displaying even though it's installed and set to Live?
The Bundle Builder will NOT display if a step's datasource ruleset has an IF condition that requires an input product — for example, "IF Products Contain [specific product]" or "IF Page Contains [collection]." Unlike standard Rebuy widgets that are installed on product detail pages and use the current page's product as an input, the Bundle Builder lives on its own dedicated page with no input product context. When a datasource rule requires an input product to evaluate against and none exists, the rule cannot resolve and the Bundle Builder will not render.
How to fix it:
Set the IF condition in every step's datasource ruleset to IF Anything — this tells the datasource to always evaluate as true, regardless of page context.
Use the RETURN side of your datasource rules to control exactly which products appear in each step. Collection filters, tags, product IDs, and other criteria are all supported on the RETURN side.
Important: Bundle Builder datasource rules must always use IF Anything as the IF condition. Any input-product-dependent condition on the IF side will prevent the Bundle Builder from rendering. This is different from the Dynamic Bundle Widget, which is installed on product pages and can reference input products in IF conditions.
What if my custom data source is set correctly but still no products appear?
The default endpoint being used may not have product data yet. Try resyncing your products.
Why is the "floating bottom" layout progress bar and "Add Bundle to Cart" button in the Bundle Builder scrolling with the page instead of staying fixed at the bottom?
This issue could be caused by the "Reveal sections on scroll" setting being enabled in the app block settings or in the animations settings within your theme editor. When this setting is active, the progress bar and the "Add Bundle to Cart" button scroll along with the page, rather than staying fixed at the bottom. If the sticky behavior persists even after modifying these settings, it may be due to restrictive CSS rules in the parent container. Check the CSS rules for the parent container and ensure that properties like overflow are not interfering with sticky functionality.
What if a sticky header is covering part of the Bundle Builder, particularly when using the "on scroll up" style sticky header?
If you're experiencing issues with a sticky header covering part of the Bundle Builder, especially with the "on scroll up" style, it’s a good idea to disable the sticky header on the Bundle Builder page. Sticky headers can interfere with the visibility of certain page elements, including the progress bar and the "Add Bundle to Cart" button.
To disable the sticky header:
Go to your header settings in your Shopify theme editor.
Find the option for sticky headers.
Set the sticky header specifically for the Bundle Builder page to NONE.
Data Handling
How does Rebuy’s Bundle Builder retrieve and display product data?
Rebuy’s Bundle Builder pulls product data from your store’s catalog via Rebuy’s API or a configured custom data source. It dynamically displays products based on bundle rules, AI-powered recommendations, or manually configured selections.
How does real-time cart updating work with Bundle Builder?
The system listens for changes to the cart and updates pricing, discounts, and eligibility rules in real time. It integrates with the store’s cart API to ensure modifications are instantly reflected.
Bundle Logic & Customization & Integrations
How does the dynamic discounting feature work?
The discount engine applies percentage-based or fixed discounts when customers meet the bundle criteria. Discounts update dynamically as items are added or removed from the bundle, ensuring accurate pricing.
Can I limit the number of items a customer can add per bundle step?
Yes, merchants can configure min/max quantity rules for each step in the bundle builder settings. These limits help ensure structured bundling and prevent excessive item selections.
How do I enable review integrations within the Bundle Builder?
Review integrations (e.g., Yotpo, Loox, Judge.me) can be enabled by connecting the relevant review platform within the Rebuy admin panel. Once connected, product reviews will be dynamically displayed within the bundle selection UI.
Is it possible to use a custom template for Bundle Builder?
Yes. The Bundle Builder is built on Rebuy's Widget architecture, which fully supports custom templates and front-end customizations.
Can Bundle Builder be influenced by prior steps?
No ,Bundle Builder steps can't be influenced by the product selected in the step prior.
Data Handling
How does Rebuy’s Bundle Builder retrieve and display product data?
Rebuy’s Bundle Builder pulls product data from your store’s catalog via Rebuy’s API or a configured custom data source. It dynamically displays products based on bundle rules, AI-powered recommendations, or manually configured selections.
Cart Transforms & Reporting
Are cart-transformed items treated as unique entries?
Yes, each Cart Transform bundle is treated as a unique cart line item in the Smart Cart. The bundle appears as a single parent line item with a combined price and a collapsible dropdown showing the individual products inside. At checkout and in Shopify Admin orders, the individual products appear as separate line items for fulfillment purposes.
If you're using Bundle Builder's Items Grouping (available with the Shopify Functions discount mechanism) along with the Smart Cart's Nested Cart Items setting the behavior is similar — the parent line item represents the bundle in the cart — but each child item retains its own quantity selector and can be individually adjusted or removed.
How are discounts reflected in reporting for different bundle types?
Cart Transform API bundles will display only the final bundle price in reporting. Shopify Functions-based discounts will show original price and discounted amount clearly in Shopify’s sales and product reports.
Can sub-items from a cart-transformed bundle be displayed in the cart?
It depends on the discount mechanism and cart type:
Items Grouping (Shopify Functions) — sub-items are displayed natively in the Rebuy Smart Cart. Each child item appears in a collapsible dropdown under the parent line item with its own image, title, price, and quantity selector. This is the recommended approach if individual item visibility in the cart is a requirement.
Cart Transforms — Cart Page (Liquid) — yes, sub-items can be rendered on a standard Shopify cart page using Liquid.
Cart Transforms — Flyout/AJAX Carts — no. Shopify's AJAX Cart API does not expose
item.components, so sub-item data is not accessible in flyout cart contexts. See Shopify Docs – line_item.item_components for more detail.
Why does Smart Cart show sub-item drop-downs for some bundles on other stores, but not with Rebuy's Bundle Builder?
If you use the official Shopify Bundles App, Rebuy Smart Cart can detect and render sub-items via title matching. With Bundle Builder using Cart Transforms, Shopify does not expose sub-item data in a way that Rebuy can query and render child products — this is a current Shopify platform limitation.
If you need sub-item visibility inside the Smart Cart with Bundle Builder, use Items Grouping instead of Cart Transforms. Items Grouping uses Shopify's Nested Cart Lines API, which does expose child item data to the Smart Cart and renders each item with its own controls in a collapsible dropdown. Also ensure that the Smart Cart's Nested Cart Items setting is enabled.
Inventory & Availability
What happens if a product in the bundle is out of stock?
If any product in a bundle is out of stock, the entire bundle will not be added to the cart. Shopify will display a standard error message to the shopper.
What is the maximum number of items I can include in a bundle?
The current maximum number of items allowed in a bundle is 40 items.
Advanced Use Cases
Can I offer a Gift With Purchase (GWP) in a bundle?
Yes, you can! The Gift with Purchase feature in Bundle Builder allows merchants to offer a free gift when customers purchase specific bundles. You can select up to two gifts, offer them with or without a discount, and customize the messages displayed in the cart to inform customers about their unlocked gift.
What are the different types of gifts I can offer with the Gift with Purchase feature?
Merchants can choose from two main types of gifts:
Discount + Gift: Apply both a discount and a free gift together.
Gift Only: Offer a free gift without any discount. This is ideal for promotions, giveaways, or offering free shipping. Use the Decorative Type discount for this option.
Can I add more than one gift to a bundle?
Yes, you can add up to two gifts to a bundle. These can be linked to specific variants, allowing flexibility in how the gifts are offered and which products qualify for the gift.
If gifts are available at multiple bundle tiers, does the customer have to re-select them each time?
Yes. Each tier in Bundle Builder functions as an upgrade of the previous one with no carry-forward logic. Moving between qualifying tier counts — for example, from 3 items to 4 items — resets the gift selection and requires the customer to re-select.
Will Bundle Builder's Included Gift With Purchase automatically remove the gift if the customer no longer qualifies?
Bundle Builder's Included Gift With Purchase does not auto-remove the gift item when a customer no longer qualifies. The gift item stays in the cart but the Shopify Functions discount falls off, leaving it at full price. To remove it, the customer will need to do so manually from their cart.
Ready to get started?
Check out our how-to guide to install and configure your bundle builder.
Want to learn more about features?
Check out our FAQs for more clarity on features and functionality.