🧺What are Bundles?

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

Last updated: April 10, 2024

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.

There are three 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. 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.

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.

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.

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.