Skip to main content

How to Configure & Customize Bundle Builder: Installation & Settings Guide

Create unique experiences and boost AOV with Rebuy's Bundle Builder

Christian Sokolowski avatar
Written by Christian Sokolowski
Updated this week

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

  1. 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.

  2. 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

  3. 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

  1. Open Shopify Customizer

  2. Navigate to the page where you want to add the bundle

  3. Click “Add Section” and select Rebuy App Block

  4. In Rebuy Admin, locate your Bundle ID

    • Found in Rebuy Admin or in the Bundle Preview area

  5. Copy the Bundle ID and paste it into the “Widget ID” field inside the App Block

  6. 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:

  1. In Shopify Admin, create a new product to act as the bundle container.

  2. Find the variant GID of the product:

    • Go to the product page URL and append .json to it

    • Use Ctrl+F to search for "ProductVariant" under "admin_graphql_api_id"

  3. 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:

  1. Create a single Step in the Bundle Builder.

  2. Attach a Data Source that includes the entire product collection.

  3. 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:

  1. Step 1 – Choose a serum from a list of available options.

  2. Step 2 – Choose a moisturizer from a curated selection.

  3. 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.

Did this answer your question?