---
updatedAt: 2026-04-23T18:37:55.000Z
agentTools:
siteIndex: https://docs.recurly.com/llms.txt
projectIndex: https://docs.recurly.com/recurly-commerce/llms.txt
---
# Bundles
Recurly Commerce Bundles allow customers to curate their own selection of products from a pre-defined collection.
# Overview
### Video
{`
`}
# Definition
Bundles empower your customers to build their own bundle from a curated selection of your products. By offering a personalized shopping experience and the convenience of all-in-one shipping, you create a high-value offer that increases your Average Order Value (AOV).
***
## Bundle types
Recurly Commerce supports two pricing models for Bundles:
| | Fixed Price | Flexible Price |
| :------------ | :------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------- |
| Best for | Any "3 items for $50" style promotions. | Upselling premium items within a custom box. |
| Pricing Logic | Price is defined by the Shopify Bundle Product and does not change based on the selected contents. | Price is the sum of the individual products selected by the customer. |
***
## Key benefits
* **Pricing Flexibility:** Choose between fixed or flexible pricing to best suit your business requirements.
* **Custom Constraints:** Control the size of the bundle and set limits on specific products to manage fulfillment and inventory.
* **Boost Average Order Value (AOV):** Encourage customers to add more items to their cart through a curated, guided experience.
* **Product Discovery:** Introduce customers to unique or slower-moving products by including them in a bundle collection.
***
## Key details
### Set up Recurly Commerce Bundles in your Storefront
To use Recurly Commerce Bundles, begin with adding a new template to your Online Store.
#### Create a New Product Template
1. **Open the theme editor**
1. From your Shopify admin dashboard, navigate to **Online Store** > **Themes**.
2. Locate your current theme and click **Edit theme**.
2. **Access the Product templates**
1. Select **Home page** at the top of the editor.
2. Select **Products** from the list.
3. **Create a new template.**
1. Click **+ Create template**.
2. In the **Based on** dropdown menu, select **Default product** , then set the name to "**commerce-bundles**". Select **Create template** to save your changes.
#### Configure the Template Layout
1. **Clear your product page**
To ensure a clean setup, start by hiding any existing sections currently on the page. This allows you to build the layout from scratch without visual clutter.
2. **Add the Commerce Bundle App**
1. Locate the Template area (situated between the Header and Footer).
2. Click Add section.
3. In the section modal, navigate to the Apps tab.
4. Select Commerce Bundle Builder.
3. **Adjust Theme Settings**
To ensure the best user experience, navigate to your Theme settings and disable the **Reveal sections on scroll** option. This creates a smoother visual transition as customers interact with your product page.
*Note: If this is your first time using Recurly Commerce, please remember to also add the Commerce Subscriptions Widget to your layout to ensure all features function correctly.*
#### Adjust Display Settings
Depending on the Shopify theme you are using, you may need to adjust the layout to ensure the Bundle Builder displays correctly.
1. **Select the Section:** In the left-hand sidebar of the theme editor, click on the **Commerce Bundle App** section you just added.
2. **Configure Dimensions (Optional):** Locate the **Size** settings in the side panel and apply the following:
1. Set **Width** to **Full**.
2. Set **Height** to **Full screen**.
3. **Save your changes:** Click the **Save** button in the upper right-hand corner of the screen to apply your changes.
Once your storefront is saved, you can create your bundle products and collections within Shopify.
***
### Set up bundle products in Shopify
To power a Bundle in Recurly Commerce, you must first set up a **Parent Product** (the bundle) and a **Collection** (the items inside) within Shopify.
#### Creating the Parent Product
The Parent Product acts as the "container" for your bundle. This is the primary SKU that customers will see in their cart and checkout.
1. **Create the Bundle Product**
Follow the standard Shopify process to [add a new product](https://help.shopify.com/en/manual/products/add-update-products).
2. **Set the Pricing**
Your pricing strategy depends on the type of bundle you are offering:
* **Flexible Price Bundles:** Set the price to **$0**. The final cost will be automatically calculated based on the individual items the customer selects.
* **Fixed Price Bundles:** Enter the **specific total price** you wish to charge for the entire bundle.
3. **Using Variants**
You can add variants (e.g., Small, Medium, Large) to the Parent Product for both fixed and flexible bundles.
* **Configuration:** During setup in Recurly Commerce, you can define specific product counts for each variant.
* **Constraint:** Only one level of variants is supported. Nested variants (multiple options like Color and Size) will not function within Commerce Bundles.
4. **Inventory Management**
If you track inventory on the Parent SKU, the bundle's availability is tied to that stock level:
* If inventory is 0 and "Continue selling when out of stock" is disabled, the bundle will automatically be disabled on your Product Detail Page (PDP).
#### Creating the Bundle Collection
The Bundle Collection serves as the library of items your customers can choose from to populate their bundle.
1. **Add products to your collection**\
Create a new collection and add the individual products you want to offer within the bundle
* Need help? See the [Shopify Collection Guide](https://help.shopify.com/en/manual/products/collections) for step-by-step instructions.
2. **Choose your collection type**\
You can use either manual or automated collections, but please keep the following logic in mind:
* Manual Collections: Recommended for full control. These work immediately "out of the box."
* Automated (Smart) Collections: These are supported; however, the Commerce logic only recognizes standard product fields (such as Product Type, Tag, or Price).
* Note: Custom metafields cannot be used as conditions for automated bundle collections.
***
### Create a bundle in Recurly Commerce
Once your products and collections are ready in Shopify, follow these steps to build your bundle in Recurly.
1. **Initiate the Bundle Setup**
1. Open **Recurly Commerce** and navigate to the **Bundles** tab.
2. Select **+ Create Bundle**.
3. **Internal Details:** Enter a Name and Description. These are for your internal organization only and will not be visible to customers.
1. **Choose Your Bundle Type**
Select the pricing logic that matches your business model:
* **Flexible Price Bundle:** The total price is calculated dynamically based on the specific items the customer adds to their cart.
* **Fixed Price Bundle:** The total price is pulled directly from the Parent Product price you set in Shopify.
2. **Link Your Shopify Product**
Click **+ Select Product** and choose the Parent Product you created in Shopify.
One Product per Bundle: A Shopify product can only be linked to one bundle at a time. If a product is already assigned to another bundle, it will not appear in the selection list.
1. **Complete the bundle type configuration.**
1. If offering a flexible bundle, set the minimum and maximum size by entering the number of products allowed. If no maximum is set, it will default to unlimited.
2. If offering a fixed bundle, set the bundle size by variant. In the example above, a small could have 2 products, while a large could allow a customer to select 6.
2. **Define Bundle Contents**\
Select the Shopify collection you created previously. This populates the bundle with the specific items your customers can choose from.
1. **Set Single Product Limits *(Optional)***
You can enforce a Single Product Limit to prevent customers from adding too many of the same item to a single bundle (e.g., "Max 2 of any specific flavor").
***
### Creating a Subscription Plan for your Bundle
Now that your Shopify components and Commerce Bundle are configured, you can wrap them into a subscription offer.
1. **Create the Subscription Offer**
1. Navigate to **Subscription Plans** in Recurly Commerce.
2. Click **+ Create Offer**
3. **Internal Information:** Enter the Subscription Offer Group Name and Description. Like the bundle settings, these are for internal tracking and are not visible to customers.
2. **Attach Your Bundle Product**
1. Click **Add Product** and select the **Parent Bundle Product** you created in Shopify.
2. Click **Confirm**.
Note: Bundle products must stand alone on subscription plans. You cannot add additional, non-bundle products to the same subscription plan.
3. **Configure Purchase Options**
Bundles currently support two purchase models on subscription plans:
* **One-time purchase:** A single, non-recurring sale.
* **Subscribe & Save:** A recurring subscription with optional discounted pricing.
4. **Customize the Subscription Experience**
Configuring your plan with the following:
* **Swaps & Add-ons:** Define which products customers can swap in the future.
* **Discounts:** Apply special pricing based on order frequency or item quantity.
* **Shipping:** Enable Free Shipping for this specific offer if desired.
* **Contract Terms:** Set specific contract terms (e.g., a 3-month minimum commitment).
* **Cancellation Flow:** Define the steps or retention offers a customer sees if they attempt to cancel.
5. Go Live
Once you have reviewed your settings, click **Publish Offer** in the upper right-hand corner. Your bundle is now live and ready for customers!
***
### Frequently Asked Questions
#### Gifting & General Features
* **Can customers gift a bundle subscription?** Yes! Bundles are fully compatible with gifting. To enable and configure gift options, please contact our support team at for assistance with the setup.
* **Can customers pause a bundle subscription?** Yes, if you have enabled the Pause Subscription feature in your Customer Portal settings, customers can pause their bundles. All standard pause logic (duration limits, resume dates, etc.) applies.
#### Product Swaps & Pricing
* **Can customers swap products within their bundle?** Yes, customers can swap individual items for any other item within the approved Shopify collection.
* **Fixed Price Bundles:** The price remains the same regardless of the items chosen. However, if a customer changes their bundle size (e.g., upgrading from a Small to a Large), they will be charged the price associated with that new variant.
* **Flexible Price Bundles:** The customer will be charged the total price of the new items they have selected.
**Can customers include add-ons with their bundle?** Yes, customers can add both subscription and one-time add-ons. These are configured during the Subscription Plan setup and will be billed alongside the bundle.
#### Inventory & Stock Issues
**What happens if a product in the collection goes out of stock for new customers?** Recurly Commerce syncs with Shopify inventory. If an item reaches zero stock, it is automatically labeled "Out of Stock" in the storefront widget to prevent a customer from selecting that item. It will automatically be available for selection once inventory is replenished in Shopify.
**What happens to active subscriptions if a product goes out of stock?** If a product becomes unavailable for an existing subscriber, Recurly Commerce can trigger an automated notification. This alert prompts the customer to manage their subscription and select a replacement item before their next renewal.
**Still need help?**
If you have additional questions or need assistance with your setup, please contact our support team at .
# Sibling pages
* [Overview: Advanced features](https://docs.recurly.com/recurly-commerce/docs/advanced-features.md)
* [Bulk updater](https://docs.recurly.com/recurly-commerce/docs/bulk-updater-in-recurly-commerce.md)
* [Gift subscriptions](https://docs.recurly.com/recurly-commerce/docs/gift-subscriptions-in-recurly-commerce.md)
* [Automations](https://docs.recurly.com/recurly-commerce/docs/automations.md)
* [Compass AI Assistant](https://docs.recurly.com/recurly-commerce/docs/compass-assistant-in-commerce.md)