# Bundles {% hint style="warning" %} **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 →](https://help.smartrr.com/docs/support/admin-portal/bundle-app-block) {% endhint %} Last updated: May 14, 2025 Bundles features are available to merchants on our [💎 Excel plan](https://help.smartrr.com/docs/getting-started/onboarding/plans). 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*](#how-to-create-a-bundle-in-shopify) 2. [How to create a Bundle in *Smartrr*](https://help.smartrr.com/docs/support/admin-portal/what-are-bundles#how-to-create-a-bundle-in-smartrr) 3. [Injecting Bundle snippets into your theme](#injecting-bundle-snippets-into-your-theme) 4. [Rendering your bundle](#rendering-your-bundle) 5. [How to implement Bundles on your live site](#undefined) ## 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. {% hint style="info" %} **🖼 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. {% endhint %}

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.

{% hint style="info" %} **Note:** If the variants within your parent bundle product will contain different options, create a different collection for each different bundle variant. \ \ \&#xNAN;*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.* {% endhint %} ## 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. {% hint style="warning" %} **Double check:** Make sure the same items you added above in your [Shopify bundle collection](#2.-create-a-collection-for-your-bundle-product) *AND* your [parent dummy bundle product](#1.-create-a-dummy-bundle-product) are all selected as products within the Subscription Program you are about to choose. {% endhint %}

{% hint style="danger" %} **Warning:** You won't be able to change the subscription program associated with this bundle after you've pressed **Save**. {% endhint %} Next, select the [parent dummy bundle product](#1.-create-a-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.*

{% hint style="info" %} **📦 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?](#undefined) {% endhint %} Finally, add as many **Bundle Variants** as you linking to the variants you set up in Shopify for your [parent dummy bundle product](#1.-create-a-dummy-bundle-product). Link the variant to the [collection you created in Shopify](#2.-create-a-collection-for-your-bundle-product) 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: ```html {% 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](https://help.smartrr.com/docs/getting-started/onboarding/plans), 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. {% hint style="info" %} 💻 Developers can find additional technical support for bundles by viewing: [Bundles: Developer Documentation](https://help.smartrr.com/docs/support/developer-documentation/bundles-developer-documentation). {% endhint %} ## 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:

{% hint style="info" %} **⏰ 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. {% endhint %} 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.