Rebuy's Bundle Builder is a powerful tool that enables brands to create customizable product bundles, offering a seamless way for customers to mix and match products while unlocking discounts, meeting quantity requirements, and enhancing their shopping experience.
Additionally, Rebuy offers Dynamic Bundles, which provide customers with a simple way to add predefined sets of products to their cart with one click.
Configuring and Installing Bundle Builder
Step 1: Access and Configure the Bundle Builder
Create Your Bundle
Navigate to the "Bundle Builder" tab.
Click "Get Started" to begin setup.
Enter a recognizable name to easily identify it later.
Customize Your Bundle
After naming, you'll be directed to the Bundle Builder Editor where you can:
Configure settings and layout
Select products to include
Set discounts
Customize the bundle layout
Save your settings and copy your Bundle ID.
Bundle Builder limit: 30 per store
A Rebuy store can have up to 30 Bundle Builders at one time. When a store already has 30 and you click Create New, the Create Your Bundle Builder window shows the message You have reached the maximum number of widgets allowed and the Create Bundle button stays disabled.
Step 2: Install the Bundle Builder on Your Shopify Store
Rebuy's Bundle Builder is installed using an App Block inside Shopify's Customizer. Here's how to set it up:
1. Create or Select a Shopify Page for the Bundle Builder
New Page: If you want a dedicated page for your bundle, follow these steps:
Go to Shopify Admin > Online Store > Pages
Click "Add Page"
Enter a page name (e.g., "Bundle Builder")
Save it as visible when ready
Existing Page: If you want to add the Bundle Builder to an existing page, you can skip this step.
2. Add the Page to Your Store's Navigation
To ensure customers can access the bundle page:
Go to Shopify Admin > Online Store > Navigation > Menus
Select the menu where you want to add the page (e.g., Main Menu)
Click "Add Menu Item"
Enter a name (e.g., "Build Your Bundle")
Link it to the new bundle page (you can search for the page name instead of pasting the URL)
Click Save
3. Install the Rebuy Bundle Builder App Block
Open Shopify Customizer
Navigate to the page where you want to add the bundle
Click "Add Section" and select Rebuy App Block
In Rebuy Admin, locate your Bundle ID
Found in Rebuy Admin or in the Bundle Preview area
Copy the Bundle ID and paste it into the "Widget ID" field inside the App Block
Click Save
📌 Final Step: Ensure your bundle is set to "Live" in Rebuy Admin. Once activated, it will appear on the Shopify page you configured.
Bundle Builder Layout Options
Rebuy's Bundle Builder offers two predefined layout options for desktop screens including a side by side option and floating option. Each Layout Option comes with three potential views - default, tab and collapsible:
For more advanced layout customizations, such as creating unique designs or adjusting specific features, advanced techniques using CSS or JavaScript can be employed.
Side by Side Layout
The Bundle Container (where products added to the bundle are stored before the customer adds them to the cart) is fixed to the right side of the screen.
This layout keeps the bundle contents visible while the shopper selects products.
Floating Bottom Layout
The Bundle Container is fixed to the bottom of the screen and remains sticky upon scroll.
The container rolls up into a flyout that can be expanded upon click, keeping the shopping experience clean and unobtrusive.
This layout allows for a more compact design, ensuring the bundle stays accessible without taking up side space.
Pro tips:
The floating bottom layout is the default layout for mobile screens
If you want the bottom bar to always stay visible, make sure the "reveal sections on scroll" setting is turned off in your Shopify theme to prevent any unintended scrolling behavior.
Different View Options
The Bundle Builder layout options above can each leverage different view options for your products, steps, collections or any other way you want
Default View (Scrollable Steps)
Displays each step or section (e.g., Step 1, Step 2, or segmented headers like "Dry Skin") in a full-page scrollable format.
Includes a quick-scroll button that allows users to jump back to the top of each section without manual scrolling.
Tabs View
Displays each step or collection as a separate tab, allowing users to switch between them without scrolling.
Features a sticky header with all tab options visible at the top for easy navigation.
Collapsible View
Shows all steps or segments on a single page with collapsible sections that can be opened or closed individually.
Allows users to seamlessly browse and interact with multiple steps without navigating away from the page.
General Settings
Bundle Name
In this section, you can rename your Bundle Builder for internal use.
Bundle Placeholder Container Options
These settings control the minimum and maximum number of items in the entire bundle container. They also determine how placeholders are displayed when a customer starts building their bundle.
Min Bundle Container Length: Sets the minimum number of items a customer must add before the Add Bundle to Cart button becomes active.
Max Bundle Container Length: Sets the maximum total number of products a customer can add across all steps. This value drives the counter displayed in the bundle container, shown as "[amount added] / [max]" — for example, "0 / 6" means no items have been selected and the bundle allows up to 6 total. To change the counter maximum, update this field.
Subtotal Discounted From: Controls whether bundle discounts are calculated from the product's Price or Compare at Price.
Enabled Forced to Max Length: When checked, customers must add the maximum number of allowed items before the Add Bundle to Cart button becomes active.
Note: The "My Bundle" counter in the bundle container reflects the Max Bundle Container Length set here, not the Max Quantity Per Step setting found in individual step settings. If the counter maximum looks wrong, check this field first.
(Screenshot above: Rebuy Admin Bundle Builder "General" settings showing "Bundle Placeholder Container Options" with "Min Bundle Container Length", "Max Bundle Container Length", "Subtotal Discounted From", and "Enabled Forced to Max Length" checked)
For example:
If Max Bundle Container Length is set to 6, the counter will display "0/6" and customers can add up to 6 items total.
If the minimum bundle size is 1, the Add Bundle to Cart button stays disabled until at least 1 products are added.
If Enforce Max Length is enabled, customers must reach the maximum before they can add the bundle to cart.
Switch to Subscription
Switch to Subscription is the toggle in the Bundle Builder editor's General tab that lets a shopper buy the whole bundle on a recurring delivery schedule instead of as a one-time purchase. When it is on, the bundle container shows a subscribe option and a one-time option above the Add Bundle To Cart button, with a delivery interval dropdown built from the selling plans on the products the shopper added.
Full setup guide: Bundle Builder: Switch to Subscription
Product Options Settings
The Product Options Settings control how product details and interactive elements appear on each product card within the Bundle Builder.
Show Variant Options — Displays available variant choices for products in the bundle (e.g., size, color, or other selectable attributes).
Show Variant Title — Displays the title of each product variant to help customers easily identify their selections.
Show Product Description — Displays the product description beneath each item in the bundle, giving customers additional details about the product before adding it to their bundle.
Product Quick View — Enables a "Quick View" button on each product card, allowing customers to preview product details in a pop-up modal without leaving the bundle page. The modal includes images, pricing, stock availability, variant options, and quantity selection.
Example image below of how the Product Quick View feature appears live:
Custom Default Image — Replaces the default product image on each product card with a different image from the product's Shopify image gallery. When enabled, an Image Position field appears, allowing you to specify which gallery image to display as the default (e.g., entering "2" displays the second image in the product's gallery).
Custom on Hover Image — Displays an alternate image from the product's Shopify image gallery when a customer hovers over a product card. When enabled, a Hover Image Position field appears, allowing you to specify which gallery image to show on hover (e.g., entering "2" displays the second image when the customer hovers over the card).
Discounting with Bundles
Rebuy's Bundle Builder allows you to set up automatic discount tiers using Shopify Functions or group bundled items into a single line item using Cart Transform API. These discounts are applied seamlessly when customers meet the required bundle conditions.
Configurable Bundle Discount Tiers
Bundle Builder discount tiers are set in the Bundle Builder editor under Discounting, in the Tiers list. A Bundle Builder can have up to 8 discount tiers, each added with the Add Tier button. Each tier unlocks at its own Required Quantity or Required Subtotal, and each tier has its own discount type and its own optional free gift.
You can also turn on the Bundle Builder progress bar to show shoppers how close they are to the next tier. For example:
Buy 2 items, get 10% off
Buy 3 items, get 15% off
Buy 4 items, get 15% off plus a free gift, by turning on Included Gift With Purchase in that tier
Each Bundle Builder discount tier uses one of the following discount types:
Percentage takes a percentage off the bundle items, for example 10% off.
Fixed Amount takes a set amount off the bundle, for example $5 off. It is available when the Discount Mechanism is set to Shopify Functions.
Decorative takes nothing off and shows the tier's messaging only, for example to announce a free shipping threshold you offer separately.
A Bundle Builder free gift works with every one of these discount types, since you turn it on separately inside the tier with Included Gift With Purchase when the Discount Mechanism is Shopify Functions.
Threshold Options
Bundle Builder supports two types of discount thresholds using Shopify Functions:
Quantity-based thresholds: Trigger discounts based on number of items added to the bundle.
Subtotal-based thresholds: Trigger discounts based on total spend (e.g., Spend $40, get 5% off).
You can also limit line-quantity in Admin when using Shopify Functions, which ensures that bundle qualification applies only to the defined number of items and prevents manipulation (e.g., customers can't qualify by adding duplicate items beyond the intended threshold).
Required Quantity
Set the minimum number of items a customer must add to their bundle to qualify for a discount.
Each tier is based on the number of items in the bundle — for example:
Buy 3 items, get 20% off
Buy 4 items, get 25% off
Set a Bundle Builder subtotal threshold for each currency
Enable Presentment Currencies lets you type an exact Required Subtotal for each currency your store sells in, on each Bundle Builder discount tier that unlocks by subtotal. Without it, Bundle Builder converts each tier's Required Subtotal from your store's default currency at Shopify's live exchange rate, so shoppers paying in other currencies see thresholds that are rarely round numbers and that move when exchange rates move.
Bundle Builder per-currency thresholds are set in two places in the Bundle Builder editor's Discounting settings. Required Threshold, in the General Discounting card at the top, decides whether every tier in the Bundle Builder unlocks by Quantity or by Subtotal. The Presentment Currencies section, inside each tier under Tiers, holds that tier's per-currency amounts. It appears only when Required Threshold is set to Subtotal and your Shopify store sells in more than one currency, since a Quantity threshold counts items rather than an amount.
To set a per-currency subtotal threshold on a Bundle Builder discount tier:
Open your Bundle Builder in the editor and select Discounting from the settings menu.
In the General Discounting card, set Required Threshold to Subtotal. This one setting applies to every tier in the Bundle Builder.
Scroll down to Tiers and open the tier that needs per-currency amounts.
In that tier, expand the Presentment Currencies section and turn on Enable Presentment Currencies.
Under Your Currencies, find the Required Subtotal field for each currency your store sells in other than your default currency, such as Required Subtotal AUD, each in that currency's own format.
Enter the subtotal for each currency that needs its own threshold. Leave a currency at 0 to keep converting the tier's Required Subtotal at Shopify's exchange rate for shoppers paying in it.
Repeat on each tier that needs its own per-currency thresholds. Keep every currency's amounts in the same order as the tiers, so each tier's amount in a currency is higher than the amount on the tier before it.
Click Save.
Your default currency is not listed under Your Currencies, because the tier's Required Subtotal already is the threshold for your default currency.
Once saved, a shopper paying in a currency that has its own amount sees the tier label, the progress bar and tier eligibility all use that amount, and the discount at checkout applies at the same amount. For example, a store with CAD as its default currency sets Tier 1 to a Required Subtotal of CA$200.00 and enters 250.00 in Required Subtotal AUD. A shopper paying in Australian dollars unlocks Tier 1 at A$250.00, and a cart of A$208.00 gets no Tier 1 discount even though it is above CA$200.00 converted at the exchange rate.
Per-currency amounts set when a tier unlocks, not how much it takes off. A Fixed Amount discount still converts from your default currency at Shopify's exchange rate, so a CA$10.00 Fixed Discount Amount takes A$10.31 off when the rate puts CA$10.00 at A$10.31. Per-currency thresholds work with either Discount Mechanism, Shopify Functions or Cart Transforms.
Discounting Mechanisms
Shopify Functions
Ideal for dynamic, tiered discounting with full reporting support.
Supports quantity-based and subtotal-based thresholds
Allows for fixed amount, percentage, and decorative discounts
Enables line-quantity limits for stricter bundle control
Shopify Functions is fully integrated with Rebuy's native discounting system and displays detailed reporting for discount impact.
Cart Transform API
Cart Transforms uses Shopify's Cart Transform Functions API to group all selected bundle products into a single parent line item in the Smart Cart — with a combined price, a single quantity selector, and a collapsible "Show/Hide items" dropdown. The parent is a "ghost" product that represents the bundle in the cart and at checkout, but does not track inventory. Individual products appear as separate line items in Shopify Admin for fulfillment.
Simplifies the cart display — customers see one clean line item instead of multiple separate entries
Great for kits or "all-in-one" product bundles
Full setup guide: Bundle Builder: Cart Transforms and Items Grouping
Example screenshot image of the Bundle Builder's Cart Transforms setting:
Bundle Builder Cart Transforms Limitations:
Does not support the fixed amount discount type
When using Bundle Builder's Cart Transforms feature, discounts won't appear in standard Rebuy Analytics discount reporting — you'll see total revenue for the bundle, but not the discounted amount breakdown.
The individual bundled items ("child" items) do not have individual quantity selectors — customers control the entire bundle at once.
Individual subscription upgrades for child items are not supported from the cart
Items Grouping
Items Grouping is an alternative grouped cart display available when the Discount Mechanism is set to Shopify Functions. Like Cart Transforms, it shows the bundle under a parent line item with a collapsible dropdown — but each child item gets its own quantity selector and can be individually increased, decreased, or removed. It also supports individual subscription upgrades per child item.
Note: The Items Grouping toggle only appears when the Discount Mechanism is set to Shopify Functions. It is not available with Cart Transforms.
Full setup guide: Bundle Builder: Cart Transforms and Items Grouping
Example screenshot image of the Bundle Builder's Items Grouping setting:
Gift with Purchase for Bundle Builder
Bundle Builder Gift With Purchase lets you offer a free gift product when a shopper's bundle reaches a discount tier. Bundle Builder gifts are set on each discount tier, not on the bundle as a whole: every tier in the Bundle Builder editor's Discounting settings has its own Included Gift With Purchase toggle and its own gift products. Shoppers see the gift inside the Bundle Builder once their bundle reaches that tier, and they add it by clicking its Select Gift button.
Bundle Builder Gift With Purchase works with the Shopify Functions discount mechanism, which is the default, and the Included Gift With Purchase toggle appears in each tier in the editor when Discount Mechanism is set to Shopify Functions. A Bundle Builder set to Cart Transforms gives shoppers its tier discounts without tier gifts.
How to add a free gift to a Bundle Builder discount tier
A Bundle Builder free gift is added inside the discount tier that should unlock it. To set one up:
Open your Bundle Builder in the editor and select Discounting from the settings menu.
In the General Discounting card, check that Discount Mechanism is set to Shopify Functions.
Under Tiers, open the tier that should unlock the gift, or click Add Tier to create one.
Choose the tier's discount type. Pick Percentage or Fixed Amount to give a discount and a gift at this tier, or Decorative to give the gift with no discount.
Turn on Included Gift With Purchase.
Search for the gift product and select the variants you want to offer. Each tier can hold up to 2 gift products.
Optional: enter a Gift Header Message, the heading shoppers see above the gift in the Bundle Builder, and a Gift Discount Message (Optional), the discount name shown on the gift's line at checkout. When Gift Discount Message (Optional) is empty, the tier's Discount Message is used instead.
Repeat on every other tier that should include a gift.
Click Save.
To confirm the setup, build a bundle on your storefront that reaches the tier. The gift appears in the bundle container with its Select Gift button.
How shoppers add a Bundle Builder gift
Bundle Builder gifts are never added automatically. When the bundle reaches a tier with a gift, the gift appears in the bundle container under the tier’s Gift Header Message, with a variant dropdown if you offered more than one variant. The shopper clicks Select Gift to choose it, and the button changes to a remove icon so they can take it back out.
When the shopper clicks Add Bundle to Cart, the selected gift goes into the cart with the bundle items at 100% off. Nothing goes into the cart before that click.
Tier gifts replace each other rather than adding up. The gift area always shows the gifts of the highest tier the bundle reaches, and only that tier’s selected gift goes to the cart. When the bundle moves up a tier:
The gift area switches to the new tier’s gifts, and the shopper clicks Select Gift again.
A gift selected at the lower tier is not added to the cart.
If the new tier has no gift turned on, the gift area closes and the bundle goes to the cart with that tier’s discount only.
If the bundle drops back to a lower tier, the gift selected at that tier stays selected. A shopper who adds the bundle without selecting a gift still gets the bundle and its tier discount.
To keep a gift available as shoppers add more items, add it to every tier that should include it.
Offering a Bundle Builder gift with or without a discount
A Bundle Builder gift comes with or without a bundle discount depending on the discount type of the tier you set the gift on, since there is no separate gift type setting. On a Percentage or Fixed Amount tier with Included Gift With Purchase turned on, shoppers get the tier's discount on their bundle items and the selected gift for free. On a Decorative tier with Included Gift With Purchase turned on, shoppers pay full price for their bundle items and get the selected gift for free.
When a Bundle Builder gift is free at checkout
A Bundle Builder gift is 100% off at checkout as long as the items from that bundle in the cart still reach the tier the gift belongs to, so the gift's discount follows the bundle. When a shopper removes bundle items in the cart and the bundle drops below that tier, keep the following in mind:
The gift's 100% discount no longer applies at checkout.
The gift line stays in the cart at its regular price until the shopper removes it.
Can Bundle Builder add a free gift to the bundle automatically?
Bundle Builder offers the free gift to the shopper as soon as their bundle reaches a tier with a gift, and the shopper adds it by clicking Select Gift, so a Bundle Builder gift is added only when the shopper chooses it. To set up the gift, turn on Included Gift With Purchase in the tier under Discounting in the Bundle Builder editor. For gifts that Rebuy adds to the cart with no shopper action, based on cart conditions rather than a bundle, see Ways to Create a Gift-With-Purchase Offer with Rebuy.
Why don't I see a gift option in my Bundle Builder settings?
The Bundle Builder gift setting is inside each discount tier rather than in a separate gift section, so look for it in the Bundle Builder editor under Discounting, in the Tiers list. Open a tier and turn on Included Gift With Purchase to show that tier's gift product search and messages. If the tiers have no Included Gift With Purchase toggle, check Discount Mechanism in the General Discounting card, since the toggle shows when it is set to Shopify Functions. Switching from Cart Transforms to Shopify Functions also changes how the bundle looks in the cart, because Cart Transforms is what groups the bundle under one parent line item.
Can I change the text on the Bundle Builder Select Gift button?
Yes, you can change the Bundle Builder Select Gift button text by pasting a short piece of CSS, since that button label is not among the Bundle Builder editor's language settings. Paste the following CSS to the CSS box in your Bundle Builder editor's Advanced settings, and change 'Choose Your Gift' to the text you want:
/* Hide the default Select Gift text on Bundle Builder gift buttons */
.rebuy-bundle-builder__gift-product-button--add span {
display: none;
}
/* Show your own text on the button instead */
.rebuy-bundle-builder__gift-product-button--add::after {
content: 'Choose Your Gift';
}
This CSS changes the gift button on every Bundle Builder on the page where it loads.
Customizing Language & Messaging in Bundle Builder
This section allows you to modify the text displayed in the Bundle Builder, ensuring a clear and engaging experience for customers.
Header Section
Header Super Title: Displays the main title of the Bundle Builder (e.g., "Bundle Builder").
Header Title: Guides customers on the next step (e.g., "Configure your Bundle").
Header Description: Provides a short instruction or incentive (e.g., "Add products and save").
Call to Action (CTA) Section
Add Bundle to Cart Text: The button label for adding a bundle to the cart (e.g., "Add Bundle to Cart").
Adding Bundle to Cart Text: Displays when the bundle is being processed (e.g., "Adding...").
Added Bundle to Cart Text: Confirms the bundle was successfully added (e.g., "Added!").
Sold Out Text: Displays when a product or bundle is unavailable (e.g., "Not Available").
Container Section
Select a Product Placeholder Text: The text shown in empty bundle slots (e.g., "Select a Product").
Bundle Container Title: The heading for the bundle container (e.g., "My Bundle").
Enabling Review Integrations in Bundle Builder
This section allows you to integrate third-party review platforms with Rebuy's Bundle Builder, helping display product reviews directly within the bundling experience.
Available Review Integrations:
You can enable or disable integration with the following review platforms:
Klaviyo Reviews
Judge.me Reviews
Junip Reviews
Loox Reviews
Okendo Reviews
Opinew Reviews
Recharge Reviews
Reviews.io Reviews
Stamped Reviews
Yotpo Reviews
How It Works:
Toggle On to activate the integration and pull in customer reviews from the selected platform.
Toggle Off to disable the integration and hide reviews from Bundle Builder.
Configuring Steps in Bundle Builder
A step is a single selection stage in the bundle-building flow. Each step presents the customer with its own set of products, pulled from the Data Source attached to that step, and the customer makes their choices before moving on. Steps are how you break a bundle into guided, logical sections instead of dropping every product into one undifferentiated list.
You can use one step or many. A single-step bundle works like an open "pick anything from this collection" experience. A multi-step bundle turns the build into a sequence, where each step represents a category, a routine stage, or a decision point. For example, a skincare routine might use one step for cleansers, one for serums, and one for moisturizers, so the customer assembles a complete set without guessing what goes together.
Each step is independently configured. You control which products appear (via its Data Source), the step's title and description, and its quantity rules (Min Quantity Per Step, Max Quantity Per Step, Max Quantity Per Product). This lets you enforce structure where you need it, such as requiring exactly one item from a step, while leaving other steps open-ended. Steps also drive the layout: in Tabs, Default, and Collapsible views, each step renders as its own tab, scroll section, or collapsible panel.
Bundle Builder Steps Settings
Below are each of the settings with the Bundle Builder's Steps setup.
Endpoint Selection
By default your endpoint uses Rebuy's AI-powered recommendations to suggest the most relevant products for customers. You can also create a new data source if you prefer manually curated product selections.
Data Source IF condition requirement for Bundle Builder
Bundle Builder steps must always use IF Anything as the IF condition in datasource rulesets. Because the Bundle Builder is installed on a standalone page rather than a product detail page, it has no input product context to evaluate against. Any IF condition that references a specific product, collection, tag, or page will prevent the Bundle Builder from displaying. Use the RETURN side of your datasource rules to specify which products appear in each step.
Note: This requirement applies specifically to IF conditions that need a product, collection, tag, or page to evaluate against, since Bundle Builder has no such input context on its standalone page. IF conditions that don't depend on that context, such as geolocation, aren't affected by this restriction.
Language Section
Title (Optional): Customize the step's title (e.g., "Get started here").
Description (Optional): Provide additional guidance (e.g., "Choose from this collection of products.").
(Screenshot above: Rebuy Bundle Builder "Step" settings showing the "Language Settings" section)
Quantity Settings
These settings appear inside each step under Quantity Settings.
Enabled Custom Quantity Settings: Turns on per-step quantity controls (unchecked by default). When checked, the three fields below appear.
Max Quantity Per Product: Limits how many of a single product a customer can add within this step (e.g., 1 per product).
Max Quantity Per Step: Limits the total number of products that can be selected in this step (e.g., 4 items total). This is a ceiling only and does not gate checkout.
Min Quantity Per Step: Sets the minimum number of items a customer must add from this step before they can proceed. The Add Bundle to Cart button stays disabled until every step has met its minimum, including the last step. Set this to 0 (or leave it empty) on any step that should be optional.
Note: There is currently no option to automatically add multiple quantities when clicking Add to Bundle, so the minimum quantity setting enforces the quantity a customer must select before proceeding to the next step.
(Screenshot above: Rebuy Bundle Builder "Step" settings showing the "Quantity Settings" section)
Creating your Steps
Creating a Simple, Single-Step Bundle
If a brand wants to offer a large collection of products with no quantity restrictions, they can:
Create a single Step in the Bundle Builder.
Attach a Data Source that includes the entire product collection.
Leave quantity input settings blank (no restrictions).
This setup allows customers to freely select any number of products from the collection in one step.
Example:
A general merchandise store wants to allow customers to build their own gift box with unlimited product selections.
They attach a Data Source containing their full product catalog.
No additional steps or quantity restrictions are applied.
Creating a Multi-Step Bundle with Specific Product Categories
Brands can structure multi-step bundles to guide customers through specific product selections. For example, a skincare brand may want a "Build Your Own Routine" bundle with three defined steps:
Step 1: Choose a serum from a list of available options.
Step 2: Choose a moisturizer from a curated selection.
Step 3: Choose a cleanser to complete the routine.
To achieve this:
The brand creates three separate steps in the Rebuy admin.
Each step is powered by a unique Data Source, ensuring only relevant products appear in each selection phase.
The brand sets Min Quantity Per Step and Max Quantity Per Step to 1 on each step, so customers choose exactly one item per category.
Using the 'Enabled Custom Quantity' Setting
If 'Enabled Custom Quantity' is turned on for a step, it applies quantity limits at both the individual product level and the step level:
Per-product limits – Once a product reaches its max quantity, the quantity selector for that product is disabled.
Per-step limits – Once the total quantity allowed for a step is met, all product quantity selectors for that step are disabled.
This feature gives brands the flexibility to guide customers toward preferred bundling outcomes, ensuring balance in product selection while maintaining an intuitive shopping experience.
Example:
A beverage subscription box allows customers to pick up to 3 drinks per step, with a total bundle limit of 9 drinks.
They enable Custom Quantity Input, setting Max Quantity Per Product to 3 and Max Quantity Per Step to 9.
Customers can mix and match drinks but cannot exceed the step or product limits.
Note: The Step's Quantity Settings - Max Quantity Per Product, Max Quantity Per Step, Min Quantity Per Step limits selections within a single step only. It does not control the "X / Y" counter displayed in the "My Bundle" container. That counter reflects the Max Bundle Container Length setting in General Settings.
(Screenshot above: Rebuy Bundle Builder "Step" settings showing the "Quantity Settings" section with "Enabled Custom Quantity Settings" checked, "Max Quantity Per Product", "Max Quantity Per Step", and "Min Quantity Per Step")
Advanced Customization in Bundle Builder
The Advanced settings in the Bundle Builder cover placement, styling and JavaScript events.
For further customizations not included in the Bundle Builder's options or settings, you can use a Bundle Builder custom template saved in your theme code. See Developer reference: Bundle Builder custom template to get started. Custom templates are built and maintained by your own developer or a Rebuy Partner agency, and Rebuy support does not assist with building or troubleshooting custom code or templates.
HTML Div Placement
This field provides the HTML
<div>snippet containing the Rebuy ID, which is used to embed the Bundle Builder in a specific location on your store's pages.You or your developer can paste this div into your theme files to place the Bundle Builder in a specific spot on a page.
Custom CSS Styling
The Custom CSS box in the Advanced section is a CSS code editor where you or your developer add further customizations using CSS to change how the Bundle Builder looks, such as button styles, spacing, colors, and fonts.
CSS in the Bundle Builder's Custom CSS box loads on the whole page the Bundle Builder is on, so start each selector with
#rebuy-widget-followed by your Bundle Builder's ID, for example#rebuy-widget-12345, and your styling stays on the Bundle Builder without changing the rest of the page.For ready-made Bundle Builder styling examples, see Easy CSS Customization for Your Rebuy Bundle Builder.
Event Callbacks
In the Advanced settings you will find instance based event callbacks.
All Event Callbacks (similar to other widget callbacks) are triggered automatically, and allow you to couple events with your theme.
These callbacks accept JavaScript which will be executed on your store after the given Bundle Builder event.
Change the Bundle Builder layout and other customizations not included in the settings with a custom template
A Bundle Builder custom template replaces the Bundle Builder's default layout on your storefront with your own layout markup, for designs that the Bundle Builder's Layout and Product Display settings and the Custom CSS box do not cover. A Bundle Builder custom template is saved in your theme code rather than in the Bundle Builder editor. Custom template work is carried out by your own developer or a Rebuy Partner agency, and Rebuy support does not build or troubleshoot it. If you have a developer, the technical starting point is Developer reference: Bundle Builder custom template.
Keep the following in mind before you use a Bundle Builder custom template:
Text written directly into a Bundle Builder custom template, such as discount tier messages or badges, shows on your storefront exactly as written, so that text does not update when you change your Bundle Builder settings. The discount tiers themselves are set only in the Bundle Builder's Discounting settings, so template text that names a discount needs updating whenever you change those tiers.
A Bundle Builder custom template stays exactly as it was built, so changes Rebuy later makes to the default Bundle Builder layout appear on your storefront only after the template's owner copies them into your template. The Bundle Builder custom template developer reference includes Rebuy's current default Bundle Builder template, which your developer can compare against yours.
Removing the custom template from your theme code puts the Bundle Builder back on Rebuy's default layout, which shows the text and layout from your Bundle Builder editor settings.
When a Bundle Builder that uses a custom template or custom code in its Advanced settings is not working as expected, test it without that custom work first. Save a copy of the custom template and any code in the Custom CSS box and Event Callbacks, remove them, and then check the Bundle Builder on your storefront again. When the Bundle Builder works on Rebuy's default layout, the issue is in the custom template or code, which your developer or Rebuy Partner agency can then review.

























