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.
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.
If you plan to create multiple bundles (up to 10), make sure each has a unique name.
Customize Your Bundle
After naming, you’ll be directed to the Bundle Builder Editor where you can:
Configure settings
Select products to include
Set discounts
Customize the bundle layout
Save your settings and copy your Bundle ID.
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:
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.
Important to note: the floating bottom layout is the default layout for mobile screens
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 required before a customer can add their bundle to the cart. They also determine how placeholders are displayed when a customer starts building their bundle.
For example:
If the minimum bundle size is 3, the "Add Bundle to Cart" button will remain disabled until at least 3 products are added.
If the placeholder setting is 6, the interface will show six "Select a Product" placeholders when the customer begins their selection.
If "Enforce Max Length" is enabled, customers must add the maximum number of allowed items before they can proceed to checkout.
Product Options Settings
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.
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
You can create up to four discount tiers with customizable settings.
You can also choose whether or not to show a progress bar to gamify the bundle-building experience. Example:
Buy 2 items, get 10% off
Buy 3 items, get 15% off
Buy 4 items, get a free gift
Discount Type Selection
Choose from three award types:
Percentage-based discounts (e.g., 10% off)
Fixed amount discounts (e.g., $5 off)
Decorative tiers for messaging-only perks like Free Shipping or Gifts With Purchase (GWP)
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
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
Use Cart Transforms to group multiple bundled products into a single line item in the cart.
Simplifies the cart display for large bundles
Great for kits or “all-in-one” product bundles
Limitations:
Does not support fixed amount discounts
Discounts won’t appear in standard Rebuy Analytic discount reporting — you’ll see total revenue for the bundle, but not broken down by discounted amount.
How to Set Up Cart Transform Bundles
To use Cart Transform API, you’ll need to create a product in Shopify that represents your bundled item.
Steps:
In Shopify Admin, create a new product to act as the bundle container.
Find the variant GID of the product:
Go to the product page URL and append
.jsonto itUse Ctrl+F to search for "ProductVariant" under
"admin_graphql_api_id"
Paste the cleaned-up GID into the Bundle Builder config where the bundle variant is assigned.
This ensures that all selected items are grouped into one SKU at checkout.
Customizable Messaging
Discount Message: Displays a dynamic message when the discount is unlocked (e.g., "{{discount_value}} discount unlocked").
Product Placeholder Label: Guides customers by displaying an incentive message (e.g., "Buy {{required_quantity}} and unlock...").
Progress Bar Label (Optional): Shows progress toward unlocking a discount (e.g., "{{required_quantity}} items").
Automatic Discount Updates in Cart
Rebuy's Bundle Builder ensures that discounts are dynamically updated in the cart. If a customer adds or removes items from their bundle, the discount will automatically adjust based on the new item count.
How It Works:
If a customer adds more items, they may unlock a higher discount tier (e.g., moving from 10% off at 3 items to 15% off at 5 items).
If a customer removes items, the discount will adjust accordingly or be removed entirely if they no longer meet the minimum quantity for a discount.
For example:
A customer adds 3 items and gets 10% off.
They increase the bundle to 5 items, and the discount automatically updates to 15% off.
If they reduce it back to 2 items, the discount is removed.
This ensures that customers always receive the correct discount based on their bundle size, with no manual adjustments needed.
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
Rebuy’s Bundle Builder allows brands to create customized bundling experiences by defining steps, attaching product collections, and setting quantity restrictions. Currently the max number of bundle builder steps that you can configure is 6.
Bundle Step Settings
Endpoint Selection
By default your endpoint will be set to use our AI-powered recommendations to suggest the most relevant products for customers. However, you do have the option to create a new data source if you prefer manually curated product selections.
Header 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.").
Quantity Input Settings
Enabled Custom Quantity Input: Allows customers to manually select product quantities (unchecked by default).
Max Quantity Per Product: Limits how many of each product a customer can add (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).
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 also structure multi-step bundles to guide customers through specific product selections. For example, a skincare brand may want to create 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 the quantity input per step to ‘1’, so customers can only choose one item per category.
Using the ‘Enabled Custom Quantity Input’ Setting
If ‘Enabled Custom Quantity Input’ 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.
Advanced Customization in Bundle Builder
The Advanced settings in Rebuy’s Bundle Builder allow merchants to fine-tune the placement, styling and functionality of the bundle builder using custom HTML, CSS and Javascript.
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.Developers can use this data-rebuy-id to manually place the bundle within the store’s layout or theme files.
Custom CSS Styling
In the Advanced section, you will find a mini code editor that allows complete customization of your Bundle Builder using CSS or other web development techniques.
All of Rebuy's Bundle Builder styles are unique and easily targeted, ensuring that they do not interfere with the cascading styles of the rest of your site or other Rebuy widgets.
Merchants or developers can add CSS rules to modify elements such as button styles, spacing, colors, and fonts.
Event Callbacks
In the Advanced section 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.
