Skip to main content

Bundles overview

Updated over a week ago

Using Loop bundles, customers can easily select different products or variants and combine them into a single bundle or box, offered as a subscription or a one-time purchase. Post-purchase, they can manage everything from bundle contents to delivery frequency right from the customer portal. In this article, we’ll walk you through how to set up Loop bundles and guide you through all the configuration options available to get you up and running smoothly.

Check out our bundle experience available on our demo store here.


Types of bundles in Loop

You can set up two types of bundles using Loop, depending on how much flexibility you want to offer your customers.

  1. Preset bundle: With 'Preset fixed bundle' you can offer your customers a pre-selected set of items or variants. Once purchased, the contents of this bundle cannot be modified either during checkout or after purchase. It's an excellent option for those who trust in the curated selection provided and do not wish to make any changes.

Learn more about Preset Fixed Bundles.

  1. Build your own bundle (BYOB): With ‘Build your own bundle’, you can empower your customers with the choice to build their own bundles from the list of products that you provide. This not only enhances customer engagement but also allows them to tailor their purchases to their specific needs. Plus, the ability to edit their bundles post-purchase through the customer portal adds a layer of flexibility, encouraging customer satisfaction and retention.

Learn more about Build your own bundles.


Installing bundle snippets

Bundle snippet is a critical piece of code designed to club bundle product items on the cart under a single bundle title rather than as individual line items. This is also necessary to ensure that customers don't end up with invalid bundle content by removing/adding individual bundle items from the cart.

Follow the steps below to add bundle snippets in your store theme code.

  1. Navigate to Loop > Bundles > Snippets. Select the theme where you want to publish your bundle and click on the "Install bundle snippet" button.


    This will create a loop_bundle.js file in your theme code.

  2. Now next step is to add the bundle cart snippet. Click on "Add bundle cart snippet" to install. This will combine the bundle items into a single bundle product on your Cart page.


    If your card snippet is not working, you can get in touch with our support team to further debug.


Bundle preferences

Bundle preferences are grouped into sections based on the part of the bundle experience they control. These settings help brands decide how bundles should appear across the product page, cart, and checkout, and how much clarity customers should get while building or purchasing a bundle.

This section can be useful when a brand is deciding how they want the bundle journey to behave before going live.

  1. General preferences

These settings control how bundle information is shown across the storefront and checkout.

  • Show bundle name on checkout:

    • Enable this setting to display the bundle name with each bundled product on the checkout page.

    • This helps customers understand that the items were added as part of one bundle purchase, especially when child products appear as separate line items at checkout. It is useful for brands that want a clearer checkout experience and better visibility into bundled items.​

  • Hide bundle selling plans:

    • Enable this setting to hide bundle-related selling plans from individual product pages.

    • This is useful when the brand wants customers to access bundle purchase options only through the dedicated bundle flow. It helps keep the buying journey clean and avoids confusion between standalone products and bundle offers.

2. Preset bundle

These settings apply to preset bundles and define how the bundle is represented during checkout.

  • Configure preset bundle checkout experience: This setting decides whether checkout should begin with the parent bundle product or with the individual child products inside the bundle.

    • Checkout with parent bundle product directly: The customer checks out with the parent bundle product. Loop then edits the checkout order to add the child products in the required quantities at zero value.

      This option is useful when the brand wants the bundle to feel like one main product during the purchase flow and in their order details.

    • Checkout with bundle child products: The customer checks out with the individual child products that make up the bundle.

      Loop bundle snippets can still group these items on the cart page, but during checkout, each product is shown separately. This is useful for brands that want more visibility into each bundled item.

3. Build your bundle

These settings apply to the Build your bundle experience.

  • Out of stock products handling: Controls how unavailable products are shown on the bundle page.

  • Show as disabled: Out-of-stock products remain visible but cannot be selected.

  • Show product description drawer: Displays the full product description in a drawer when a customer clicks on the product image.

  • Selected products drawer (Legacy experience): These settings apply only to the legacy selected products drawer experience.

  • Auto-open selected products drawer on first product addition: Automatically opens the selected products drawer when the first product is added. If disabled, customers need to click Show to open it manually.

  • Display one card per product variant on bundle drawer: Controls how selected items are grouped inside the drawer. When enabled, each selected variant is shown as a separate card.


Custom bundles using Loop APIs

Loop custom bundles allow brands to create flexible bundle purchase experiences on their storefront. Developers can use Loop bundle APIs to power both preset bundle purchases and Build your own bundle (BYOB) experiences.

  • Custom widget preset bundles setup : This guide explains how to pass child SKUs when adding a preset bundle to cart while building your own custom widget to sell subscriptions instead of using the Loop widget.

  • Sell and edit BYOB using storefront bundle APIs - This guide explains how to implement a custom build your own bundle (BYOB) experience using Loop bundle APIs to sell and update subscription bundles from a custom storefront experience.


Need help?

No worries - we're here for you!

If you have any questions or need assistance, feel free to email us at [email protected] or chat with us using the support beacon at the bottom right of your screen.

Regards,

Loop Subscriptions Team 🙂

Did this answer your question?