Bundles
Bundles allow you to offer "build-a-box" style subscriptions for your customers.
Last updated
Was this helpful?
Bundles allow you to offer "build-a-box" style subscriptions for your customers.
Last updated
Was this helpful?
Last updated: May 14, 2025
Bundles features are available to merchants on our . With Bundles, you can offer "build-a-box" style subscriptions for your customers by allowing them to curate their own assortment of recurring products.
There are several parts to setting up Bundles with Smartrr, outlined below:
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.
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.
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.
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.
Warning: You won't be able to change the subscription program associated with this bundle after you've pressed Save.
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.
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.
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.
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:
Paste the code into the page, and then click "save".
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!
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".
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.
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.
Smartrr offers two ways to pass bundle information to your 3PL for picking and packing:
As custom attributes
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:
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:
This will allow you or your 3PL center to fulfill items at a line-item level:
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.
Double check: Make sure the same items you added above in your AND your are all selected as products within the Subscription Program you are about to choose.
Next, select the 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:
Finally, add as many Bundle Variants as you linking to the variants you set up in Shopify for your . Link the variant to the in the above step.
On our , you have access to our implementation team which can help you get Bundles up and running on your shop.
💻 Developers can find additional technical support for bundles by viewing: .
