🧺Bundles

Bundles allow you to offer "build-a-box" style subscriptions for your customers.

Note: There’s now a new, no-code way to launch bundles using the Smartrr Bundle App Block—no theme edits required. We recommend using this method for faster setup and improved compatibility with Shopify 2.0. Learn more →

Last updated: May 14, 2025

Bundles features are available to merchants on our 💎 Excel plan. With Bundles, you can offer "build-a-box" style subscriptions for your customers by allowing them to curate their own assortment of recurring products.

Learn how to build your own beautiful bundles!

There are several parts to setting up Bundles with Smartrr, outlined below:

1. How to create a Bundle in Shopify

2. How to create a Bundle in Smartrr

3. Injecting Bundle snippets into your theme

4. Rendering your bundle

5. How to implement Bundles on your live site

How to create a bundle in Shopify

1. Create a dummy bundle product

Create a bundle product to sell in Shopify by navigating to Products and clicking Add product.

Fill in product details, including name, photos, price, etc.

🖼 Note: Ensure your parent bundle has at least one photo, as this is what will display in your customers' account portals if they go to edit their bundles.

Add at least one Variant. If your bundle is determined by size we recommend setting up variants something like 4 pack, 6 pack, 8 pack etc.

Make sure that your products are in stock, and then Click Save.

2. Create a collection for your bundle product

In order to know which products can be included in this bundle, create a new collection in Shopify with all potential bundle products. We recommend naming this collection the same as your newly created dummy bundle parent product. Set the Collection type to Manual.

A manual collection will always include the same products of your own selection, unless you add or remove them yourself

Only add the products you want to be available as options within the bundle. DO NOT add the parent dummy bundle product to this collection.

Note: If the variants within your parent bundle product will contain different options, create a different collection for each different bundle variant. Example scenario: Parent bundle has three variants, A, B, C. Variant A offers products D, E, F Variant B offers products, D, E, F Variant C offers products D, E, G In above scenario, two collections would have to be made for the parent bundle; one to reference bundle products for Variants A & B and one to reference bundle products for Variant C.

How to create a bundle in Smartrr

In Smartrr, navigate to Subscription Programs and Bundles. Click Create bundle.

The first step is to select a Subscription Program to link the bundle you're about to create.

Double check: Make sure the same items you added above in your Shopify bundle collection AND your parent dummy bundle product are all selected as products within the Subscription Program you are about to choose.

Warning: You won't be able to change the subscription program associated with this bundle after you've pressed Save.

Next, select the parent dummy bundle product you created above as your Bundle Product. *You will not see this as an option in the modal if the product has not been added to your Subscription Program first.

📦 Tip: Check Use line items if you'd like to pass individual bundle items to your 3PL as line items or custom attributes as opposed to the parent bundle SKU. Read more in our FAQ section below: How are Smartrr bundles passed to my 3PL?

Finally, add as many Bundle Variants as you linking to the variants you set up in Shopify for your parent dummy bundle product. Link the variant to the collection you created in Shopify in the above step.

Be sure to label and describe each variant appropriately!

Once you've completed this step, you've now built the bundle product within Shopify, created an associated collection with variants included, and linked the bundle with a subscription program in Smartrr.

From here, we need to properly implement bundles on your live site by creating a new bundles page, and "injecting" the Smartrr bundle snippet into the code of your live theme.

Injecting Bundle snippets into your theme

To inject the bundle snippet onto your live theme, navigate to the theme in Shopify, click the three dots to the side, and then "edit code"

Go to"add a new template" on the left side, and select "page" as the template type. Then select "liquid", and name the bundle to something relevant. This will create a new page in Shopify for your bundle.

Liquid is an open-source template language created by Shopify and written in Ruby. Described as "the backbone of Shopify themes", Liquid is used to load dynamic content on Shopify storefronts.

Now you've created the page, scroll down to Snippets, and you'll find the Smartrr bundle snippet you created earlier, it should be titled "smartrr-bundle-bundle name.liquid". In this example, "smartrr-bundle-georges-tea-box.liquid".

Double click the snippet, and it'll "inject" the bundle code onto the new page you've just created.

Now we've injected the snippet, we need to render the code to make it visible and functional on our live site.

Rendering your Bundle

Navigate back to the bundle page we created, and add the Smartrr bundle render code.

This part of code will always be the same, just changed to reflect the name you gave your bundle. In this example, the render code looks like this:

{% render 'smartrr-bundle-georges-tea-box' %}

Paste the code into the page, and then click "save".

Adding multiple bundles in one store will add a layer of complexity to this code, but this is what a simple bundle page looks like in the backend

Once you've saved, navigate back to Shopify, go into the "Online Store" sales channel, and then click "Pages". From there, click "Add page".

Name the page the same as your bundle, and click the drop-down "Theme template" on the right-hand side. You should see the template we created in the backend appear as an option. Select it and click save.

If you click "View page" from here, you'll be directed to your (very basic) bundle page!

How to implement Bundles on your live site

The ability to trigger the Bundles modal can be placed anywhere on your site. For example, it can live on your parent bundle PDP as a CTA button: "Build my bundle".

On our 💎 Excel plan, you have access to our implementation team which can help you get Bundles up and running on your shop.

Once installed, the Bundles modal can also be styled with custom colors and typography by editing the CSS on the snippet smartrr-bundle-css.liquid in your theme’s liquid code.

💻 Developers can find additional technical support for bundles by viewing: Bundles: Developer Documentation.

Frequently Asked Questions

I removed a bundle item from my Shopify collection and subscription program. Why do my customers still see the item in their account portal when they are editing their bundle?

Currently, while bundle items removed from your Shopify collections and subscription program will no longer be available new customers to add to their bundle, it will still show up for customers who have already purchased subscriptions a bundle with this item. This is a known issue, and Smartrr is actively working on a fix. Please contact your CSM for more information.

How are Smartrr bundles passed to my 3PL?

Smartrr offers two ways to pass bundle information to your 3PL for picking and packing:

1. As custom attributes

2. As line items

By default, Smartrr appends bundle items to a Shopify order with the custom attributes. When this is the case, your customers' orders in Shopify will look something like the below:

In the above instance, the items in the parent bundle All-In Cheese Fruit box are separated as custom attributes Cheese No Variant: 1, Grapes Red Globe: 1, and Ben's Cheese: 1. The attribute _smartrr_info appends a JSON breakdown of included bundle variants and their associated selling plans.

Alternatively, you can check to enable Use line items when creating your bundle:

When line items are enabled, your customers' orders in Shopify will look something like the below:

When line items are enabled, the Smartrr app will automatically go in and edit the Shopify order to append order items. Bundle items are added at a 100% discount.

This will allow you or your 3PL center to fulfill items at a line-item level:

⏰ Timing note: When using line items, the Smartrr app will update the order items in Shopify as soon as Shopify fires an ORDER_UPDATE webhook. This means that the order you see in Shopify should be nearly instantaneous, however we recommend having at least a 10 minute delay to be safe before Shopify order information is relayed to your 3PL to ensure that Smartrr has had time to add line items.

To validate an order has been updated with line items, your 3PL can check for order line item properties in the ORDER_CREATE payload. If this payload contains _smartrr_info then the 3PL should continue to wait on that order for another 10 minutes.