Skip to content
RockStarUI Docs

Bundle Builder

What this page does

Section titled “What this page does”

The Bundle Builder page lets shoppers create a custom room set by selecting products from a grid. As items are selected, the right-side summary panel tracks progress, prices, savings, and checkout readiness.

Bundle states shoppers see

Section titled “Bundle states shoppers see”

Before the minimum is reached

Section titled “Before the minimum is reached”

Bundle Builder page showing the initial state with 0 out of 3 selected, product grid on the left, and summary panel on the right with the checkout button locked until minimum items are added.

After the minimum is reached

Section titled “After the minimum is reached”

Bundle Builder page showing 3 out of 3 selected, selected items listed in the summary panel with remove buttons, savings and total visible, and the Checkout bundle button enabled.

How shoppers build a bundle

Section titled “How shoppers build a bundle”
  1. Open the Make Your Bundle page.
  2. Choose product options (variant dropdown) on each card as needed.
  3. Click Add to bundle on a product card.
  4. Repeat until the minimum count is reached (default: 3 items).
  5. Review selected items in the Your bundle panel.
  6. Click Checkout bundle to add selected variants to cart in one step and continue to cart.

How shoppers remove products from a bundle

Section titled “How shoppers remove products from a bundle”

Shoppers can remove items in two ways:

  1. Click ✓ Added on the product card to toggle it off.
  2. Click the × remove button in the summary list on the right panel.

After removal, progress, totals, and checkout state update immediately.

How pricing and savings work

Section titled “How pricing and savings work”
  1. Progress gate:
    • Checkout button stays disabled until minimum items are selected.
  2. Total:
    • Summary total recalculates live as items are added, removed, or variant-changed.
  3. Sale savings:
    • If selected variants have compare-at pricing, sale savings appear in summary.
  4. Bundle extra savings:
    • Appears only when bundle discount is configured for selected items.
  5. Variant changes:
    • If a selected card’s option changes, summary item pricing updates to match the new variant.

Important behavior rules

Section titled “Important behavior rules”
  1. Minimum item count is controlled by Minimum items in section settings.
  2. One selection per product card: adding the same card again toggles remove, not quantity increase.
  3. Selection is remembered in session storage for the current browser tab/session.
  4. Checkout action posts selected variants to /cart/add.js and redirects to /cart.
  5. If checkout add fails, button state resets and shopper can retry.

Merchant setup in Theme Editor

Section titled “Merchant setup in Theme Editor”
  1. Go to Online Store -> Themes.
  2. Click Customize.
  3. Open a page using the page.bundle-builder template.
  4. Select Bundle builder page section.
  5. Configure:
    • Hero image
    • Heading
    • Subheading
    • Products collection
    • Products to show
    • Minimum items
    • Products heading
    • Products text
    • Summary heading
    • Summary text
    • Empty state text
  6. Add/edit Benefit blocks for summary panel trust points.
  7. Save.

Common merchant tasks

Section titled “Common merchant tasks”

Change required bundle size

Section titled “Change required bundle size”
  1. Update Minimum items.
  2. Verify progress copy and button text in preview.
  3. Save.

Restrict which products can be bundled

Section titled “Restrict which products can be bundled”
  1. Set Products collection to a curated collection.
  2. Set Products to show to desired limit.
  3. Save.

Improve empty-state guidance

Section titled “Improve empty-state guidance”
  1. Update Empty state text with clear shopper instruction.
  2. Save and test with no selections.

FAQs

Section titled “FAQs”

Why is Checkout bundle disabled?

Section titled “Why is Checkout bundle disabled?”

The shopper has not yet reached the configured minimum item count.

Why did an item price change after selecting it?

Section titled “Why did an item price change after selecting it?”

The shopper changed variant options; summary always reflects the currently selected variant.

Why do I see sale savings but no bundle extra savings?

Section titled “Why do I see sale savings but no bundle extra savings?”

Sale savings come from compare-at pricing. Bundle extra savings only appear when bundle discount is configured for selected items.

Can shoppers add quantity 2 of the same bundle card?

Section titled “Can shoppers add quantity 2 of the same bundle card?”

Not through one card selection. The current flow is one selected item per product card.

Section titled “Related guides”

Publish checklist

Section titled “Publish checklist”
  1. Verify page template is page.bundle-builder.
  2. Verify collection and product limit are correct.
  3. Verify minimum item threshold and button behavior.
  4. Test add/remove from both card and summary panel.
  5. Complete a test checkout from bundle to cart.

Need help?

Section titled “Need help?”

If you still need help, contact support via the Contact page.