Build your bundle gives your customers the choice to build their own bundles from the list of products you provide, so they can tailor their purchases to their specific needs. Your customers can also edit their bundles post-purchase through customer portal. This article covers prerequisites, setup steps, the customer and merchant experience, customization options, and FAQs.
Key features of Build your bundle
No custom code required. Get started with bundles in a few steps.
Create fixed-size or range-based bundles based on your needs.
Offer tier discounts to your customers to increase average order value.
Offer multiple purchase options such as "subscription only" and "subscription + one-time."
Customize your bundle page to match your storefront with additional CSS and custom JS.
Enable edit bundle from cart to increase conversion for build your bundles.
Before you start
In Loop, create a selling plan that you want to target for your bundle.
Map products to the selling plan which you want to sell via the bundle.
Install the latest bundle snippet or update to the latest version on the choice of theme.
Note: Bundle discounts apply over and above the selling plan discounts.
Setting up Build your bundle
Navigate to Loop admin > Bundles, then click Create your bundle > Build your bundle.
Next step is to configure the general settings. You can add the following through general settings:
Name - Enter the bundle name which will be visible on your storefront.Internal name - Enter the internal name which won't be visible to your customer
but will be helpful in internal tracking.Bundle image - Upload the bundle image which will be visible on your storefront.
Optional steps :
Description - You can enter a description for your bundle.
Footer - You can add a footer to your bundle.
Select the purchase option as 'Subscription' or 'One-time + subscription' and link a selling plan to the bundle.
Note: Build your bundle can not be sold as ‘One-time only’.
Choose your item display option under Item display options. This controls how products appear to customers on the bundle builder page:
Product cards: Displays a card for each product. Customers can choose specific variants from dropdown menus within each product card.
Variant cards: Displays a separate card for each variant of a product. Each variant appears as its own individual card.
Click on ‘Link selling plans’ and select the selling plan.
Use the Excluded products setting to hide specific products from the bundle builder. Any products you select here will not be shown to customers as options to add, whether as one-time or subscription items. This is useful when certain products in the linked selling plan should not be available inside this particular bundle.
Select the bundle size options as Fixed or Range. There are two types of 'Build Your Bundle' available at Loop:
Fixed size bundles require the customer to add the exact number of items you define. You can add multiple size options.
Range-based bundles require customers to meet the minimum and maximum item criteria. They can choose any number of products within that range
Additionally, you can offer tier-based discounts depending on the number of items.
Optional - Add categories to the bundle by selecting "Yes, I want to create categories in bundle."
Steps to add categories in a bundleAdd the title for your category.
Optional - Add the subtitle and category image
Map products for your categories.
Optional - You can set a limit for each category by clicking Set category product level limit.
Set up Filters to help customers narrow down the product list on the bundle builder page.
Three filter types are available: product option (based on variant options like Size or Color), product metafields, and product tags.
For each filter, you can configure the selection behavior (single or multiple select), display behavior (show all unique values or only specified values), and the display order on the bundle builder screen.You can choose to limit the number of the same product to be added by a customer.
To limit the same product count - Select "Yes, I want to limit the quantity of same product" and configure the maximum quantity allowed.
The next step is to configure discounts for your Bundle. You can add tiered discounts too.
The discounts offered can be of two types:Fixed discount, which offers a fixed monetary discount.
Percentage discount which offers a percentage discount of the total bundle product value.
By default, the discount is only offered on subscription purchase option only. However you can allow the discount to be available for one time purchase option too!Choose the Add to cart action to control what happens to the customer's existing cart when they add a bundle:
Add bundle to existing cart: Keeps current cart items and adds the selected bundle.
Replace existing cart with this bundle: Clears all current cart items, then adds the selected bundle.Choose where to redirect customers after they add the bundle items to cart.
Specify a custom URL to redirect users after adding the bundle to cart. This requires API implementation to override the default cart or checkout flow.
Once you've configured all the settings, you can access the settings by clicking on items under selections section. Click on Save Bundle.
After saving, you will see bundle page URL. You can copy this and paste in your Shopify store theme as required.
Note: To add the URL to the navigation bar on your Shopify storefront, navigate to Shopify > Sales channel > Navigation > Main menu
Pre-configure the bundle builder using URL parameters
You can create links to the bundle builder (BYOB) page with a pre-selected purchase option, selling plan frequency, product variants, and variant quantities already loaded. This lets you send customers straight to a configured bundle instead of the default state.
To pre-configure a bundle link, append query parameters to the bundle URL starting with ?. The bundle builder reads these parameters and overrides the default options when the page loads.
Supported query parameters
Parameter | Description |
| Sets the purchase option. Accepted values are |
| Sets the selling plan associated with the added |
| Pre-selects product variants in the bundle. Pass Shopify variant IDs separated by commas. |
| Sets the quantity for each pre-selected variant. Pass values in the same order as |
Example:
Say you run a skincare brand promoting a morning routine bundle through an Instagram ad. You want shoppers to land on the bundle builder with the cleanser (200ml) and moisturizer (fragrance-free) pre-added, quantities set, and the monthly subscription option already selected. The pre-configured URL would look like:
In the above link:
The two variant IDs in
selectedVariantsare the cleanser (200ml variant) and moisturizer (fragrance-free variant)selectedQuantities=2,3adds 2 quantities of cleanser (200ml variant) and 3 quantities of moisturizer (fragrance-free variant)purchaseOption=subscriptionswitches the page to the subscription option, andsellingPlanId=8471052586locks in the monthly frequency from your bundle's selling plan.
Customer experience
Product view page - Customers can purchase bundles through dedicated build your bundle page.
Cart experience - Bundles appear as a single product in the shopping cart, giving customers a clear and consolidated view of their purchase. Customers can edit their bundle selection from the cart if they missed an item or added something by mistake.
Refer to this article to enable the "Edit" bundle feature on your store.
Edit bundle experience - When a customer clicks the edit button in the cart, they go to an edit bundle screen where they can update their selection. After confirming their changes, the page redirects them to the configured redirection page.
Checkout experience - Customers can see the bundle's contents on the payment page.
Customer portal experience - The customer sees the bundle as a single product along with the contents of the bundle.
Merchant experience
Loop admin portal - You can see the bundle item as a subscription, making reconciliation easier.
Shopify order page - You can see the associated bundle items at the required price for hassle-free inventory management.
Customize your bundle page
You can customize the build your bundle page to match your brand's style. The following options are available through the Loop application.
Texts: Edit the text on your bundle page to align with your store's tone.
Styles: Customize the appearance of your bundle page to match your store's branding. Additional CSS modifications are also possible.
Custom JS: Add custom JavaScript to tailor the functionality of your bundle page.
Note: Loop provides 31 JavaScript (JS) custom events triggered by various actions within the customer portal and bundle builder. Your store developers can leverage these events to build customized user experiences. Refer to the Bundle JavaScript guide to learn more
Bundle subscription management
Customers can edit the bundle items via the customer portal.
On Shopify, the associated bundle items are viewed making it easier for order processing.
FAQs
Is multi-lingual content supported on bundles?
Is multi-lingual content supported on bundles?
Yes, bundles support multilingual content. Navigate to Loop admin > Settings > Multilingual content to configure it.
How does bundle discounting work?
How does bundle discounting work?
Bundle discounts apply over and above the selling plan discount linked to the bundle.
What is the difference between filters and categories in Build Your Own Bundles ?
What is the difference between filters and categories in Build Your Own Bundles ?
The main difference between filters and categories is that an item inside the bundle can belong to only one category, but it can belong to multiple filters.
How can we offer a "Buy 3, Get 1 Free" within the BYOB - Build Your Own Bundle feature?
How can we offer a "Buy 3, Get 1 Free" within the BYOB - Build Your Own Bundle feature?
A "Buy X, Get X Free" is not supported by BYOB - Build Your Own Bundle natively or out of the box. However, there are 2 possible workarounds based on certain conditions
Without APIs - If all the products are priced at same value then they can opt in to offer 25% off on bundle value, or basically fixed discount worth a product's price. This way, customers will be able to buy 4 items at price of 3 items
With APIs - Irrespective of product prices, the brand can completely control the logic and apply a relevant discount on the create/edit bundle flow using Loop APIs. However, it is only available for the Enterprise plan, but the brand is on the Pro plan.
How do I change the subscription frequency in a bundle?
How do I change the subscription frequency in a bundle?
The selling plan linked to your bundle controls the bundle frequency. Navigate to Loop admin > Subscription > Selling plan and edit the frequency in the selling plan. You can add or remove selling plans as needed.
API endpoints
Need help?
No worries - we're here for you!
If you have any questions or need assistance, feel free to email us at support@loopwork.co or chat with us using the support beacon at the bottom right of your screen.
Regards,
Loop subscriptions team 🙂























