Rebuy offers two distinct bundle experiences: Bundle Builder and Dynamic Bundle Widget. Both are Rebuy widgets configured with their own widget ID, but they differ in how they appear, how customers interact with them, and which features they support. This article helps you understand the differences, identify which bundle product you're currently using, and choose the right one for your store.
Bundle Builder is a Rebuy widget that gives customers a guided, multi-step "build your own bundle" experience. Like every Rebuy widget it has its own widget ID, and it installs through the Rebuy Widget App Block — you paste the Bundle ID into the App Block's Widget ID field. Rebuy recommends placing Bundle Builder on a dedicated Shopify page such as /pages/build-your-bundle, because a full-page layout suits a multi-step flow, but a dedicated page is not required. You can add the App Block to any theme template that accepts one.
Dynamic Bundle Widget is a widget that displays "Frequently Bought Together" style bundles directly on your Product Detail Pages (PDPs), allowing customers to add pre-defined product sets to their cart with one click. Use Data Source Rules to control which bundles appear on specific product pages.
Important: The key distinction between these two bundle products is how customers interact with each experience. Bundle Builder guides customers through a multi-step "build your own" flow where they actively select products, while Dynamic Bundle Widget presents pre-defined product combinations that customers can add with a single click.
How to identify which bundle product you're using
If you're unsure whether your store is using Bundle Builder or Dynamic Bundle Widget, you can identify the product by checking where it was configured in Rebuy Admin and where it appears on your storefront.
Identifying Bundle Builder
You are using Bundle Builder if the following conditions apply:
Configuration location: You configured the bundle experience in the Bundle Builder tab within Rebuy Admin (not in the Widgets section)
Storefront location: The bundle experience usually lives on its own Shopify page with its own URL, such as
/pages/build-your-bundleor/pages/create-your-box. It can also sit on any other template that accepts the Rebuy Widget App Block.Native GWP access: You have access to native gift-with-purchase (GWP) functionality built directly into the bundle configuration
Setup guide used: You followed the Bundle Builder setup guide for installation
Tip: Bundle Builder is configured separately from other Rebuy widgets. If you navigate to Rebuy Admin > Bundle Builder (Dashboard Panel) and see your bundle configuration there, you are using Bundle Builder.
Identifying Dynamic Bundle Widget
You are using Dynamic Bundle Widget if the following conditions apply:
Configuration location: You created the bundle under Merchandising Widgets > Widgets > Product Page > Dynamic Bundle Widget in Rebuy Admin
Storefront location: The bundle appears as a section on your Product Detail Pages, typically positioned below the Add to Cart button, product image, or product description
Setup guide used: You followed the Dynamic Bundle Widget setup guide for installation
Tip: Dynamic Bundle Widget is managed alongside your other Rebuy merchandising widgets. If you find your bundle configuration in the Dashboard Side Panel Merchandising Widgets > Widgets > Product Page > Dynamic Bundle Widget, you are using Dynamic Bundle Widget.
Key differences between Bundle Builder and Dynamic Bundle Widget
Bundle Builder and Dynamic Bundle Widget differ in where they appear, how they're configured, and what features they support. The following table summarizes the key differences between the two bundle products.
Feature | Bundle Builder | Dynamic Bundle Widget |
Recommended placement | Dedicated Shopify page (e.g., | Section on Product Detail Pages |
Installation method | Rebuy Widget App Block, with the Bundle ID pasted into the Widget ID field. | App Block or manual div added to Product Page templates |
Configuration location | Bundle Builder tab in Rebuy Admin | Merchandising > Widgets > Product Page in Rebuy Admin |
Customer experience | Guided multi-step "Build Your Own" selection process | Pre-defined "Frequently Bought Together" bundles with one-click add |
Discounting options | Shopify Functions or Cart Transform API | Shopify Functions only |
Progress bar | Yes — built-in progress bar to gamify the experience | No |
Native gift-with-purchase (GWP) | Yes — built-in GWP functionality | No |
Best for | Customizable bundle-building experiences with structured guidance | Quick cross-sell bundles conditionally displayed on product pages |
Understanding the discounting options
The two bundle products support different discounting methods:
Shopify Functions applies bundle discounts at checkout. Both Bundle Builder and Dynamic Bundle Widget support this discounting method.
Cart Transform API groups bundled products into a single line item in the cart, displaying them as one combined product rather than individual items. Only Bundle Builder supports Cart Transform API.
Important: The most significant distinction is the customer experience. Bundle Builder provides a guided, multi-step flow where customers actively build their bundle, while Dynamic Bundle Widget offers a simpler one-click experience for adding pre-selected product combinations.
When to use Bundle Builder
Bundle Builder is the right choice when you want to give customers a guided, customizable bundle-building experience on a dedicated page.
Choose Bundle Builder if:
You want customers to have a multi-step "build your own" bundle experience where they select products through a guided flow
You need a dedicated bundle page on your store (such as
/pages/build-your-bundleor/pages/create-your-box)You want native gift-with-purchase (GWP) functionality without requiring workarounds or additional apps
You want a built-in progress bar that shows customers how close they are to completing their bundle or unlocking rewards
You need bundles to appear as a single combined line item in the cart using Cart Transform API
Tip: Bundle Builder works best for subscription boxes, "build your own" gift sets, curated sample packs, and any experience where customers benefit from guided product selection.
When to use Dynamic Bundle Widget
Dynamic Bundle Widget is the right choice when you want to add quick, pre-defined bundle offers directly on your product pages.
Choose Dynamic Bundle Widget if:
You want to display "Frequently Bought Together" style bundles on your Product Detail Pages
You need flexible placement across multiple product pages without creating dedicated bundle pages. Conditions can be built using Datasource Rules for dynamic Product Page placement.
You want a simple one-click add-to-cart experience for pre-defined product combinations
You're already managing other Rebuy widgets and want to keep your bundle configuration in the same location
Tip: Dynamic Bundle Widget works best for cross-sell bundles, accessory pairings, and complementary product suggestions that appear alongside the main product a customer is viewing.
Setup guides
Once you've determined which bundle product fits your needs, follow the appropriate setup guide for step-by-step installation and configuration instructions.
Bundle Builder setup guide
For complete instructions on installing and configuring Bundle Builder, including progress bar setup and GWP configuration, see the Bundle Builder installation and settings guide: How to Configure & Customize Bundle Builder: Installation & Settings Guide
Dynamic Bundle Widget setup guide
For complete instructions on creating and configuring Dynamic Bundle Widget on your product pages, see the Dynamic Bundle Widget setup guide: Dynamic Bundle Widget Setup Guide
Frequently Asked Questions
Which bundle product supports gift-with-purchase (GWP)?
Only Bundle Builder supports native gift-with-purchase (GWP) functionality. GWP is built directly into Bundle Builder's configuration options, allowing you to automatically add free gifts when customers meet bundle requirements. Dynamic Bundle Widget does not include native GWP support.
Is Bundle Builder a widget?
Yes, Bundle Builder is a widget. It is created in the Bundle Builder section of Rebuy Admin rather than under Merchandising > Widgets, which is why it can look like a separate product, but each Bundle Builder you create is a Rebuy widget with its own widget ID. You install it the same way you install any other Rebuy widget: add the Rebuy Widget App Block to your theme and paste the Bundle ID into the App Block's Widget ID field. Because it is a widget, it also works with the widget-level features that take a widget ID, including A/B Testing. Rebuy recommends placing Bundle Builder on a dedicated Shopify page such as /pages/build-your-bundle, because a full-page layout suits a multi-step flow, but a dedicated page is not required.
Can I A/B test two Bundle Builder configurations?
Yes, you can A/B test two Bundle Builder configurations against each other using a Widget experiment in Rebuy's A/B Testing. Create each configuration as its own Bundle Builder, then select them as the control and the variation in the experiment. The one change from a normal Bundle Builder install is which ID goes in your theme: paste the experiment's Placeholder ID into the App Block's Widget ID field instead of either Bundle ID, and leave both Bundle Builders in Live Mode so each variant renders when it is served. For the full setup, see A/B Testing | Widgets.
What is the difference in customer experience between the two bundle products?
The customer experience differs significantly between Bundle Builder and Dynamic Bundle Widget. Bundle Builder provides a guided, multi-step experience where customers actively select products to build their bundle, often on a dedicated page with a progress bar showing their progress. Dynamic Bundle Widget provides a simpler "Frequently Bought Together" experience where customers see a pre-defined set of products on a product page and can add the entire bundle to their cart with one click.
Check out our Demo Store Examples