🧱Bundle App Block

Create and display Smartrr Bundles on your Shopify store – no coding required.

Already using bundles?

If your existing bundle setup includes advanced styling, or theme-level customizations, we recommend contacting Support before switching to the App Block to avoid display issues or broken funcionality.

The Bundle App Block is a new, self-serve way to display Smartrr Bundles on your Shopify storefront—available on our 💎 Excel plan.

Instead of editing theme code or relying on our Support team to add Liquid snippets, you can now drag and drop a bundle block directly from the Shopify Theme Editor.

This unlocks a faster, more intuitive way to launch bundles, making it easier to offer customizable products that boost Average Order Value (AOV) and drive subscriptions – all without needing to write a single line of code.

Whether you want to offer "Build Your Own Box" subscriptions, mix-and-match sample packs, or flexible gift sets, the Bundle App Block gives you full control, straight from your storefront editor.

Learn how to build your own beautiful bundles!

Bundle Block Setup

While the new Bundle App Block simplifies how bundles are displayed on your storefront, the foundational steps from the original setup process are still required:

1. How to create a Bundle in Shopify

2. How to create a Bundle in Smartrr

3. Rendering your bundle

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.

Rendering your Bundle

In Shopify, go to Online Store › Themes › Customize

Navigate to the page or template where you want the bundle displayed. In this example, we’re adding the block to the default product template.

Click “Add block” ➜ Apps ➜ Smartrr Bundle

Adding the Bundle Block

Copy and paste your Bundle ID from Smartrr

Find the Bundle ID in Smartrr

Paste the Bundle ID in the App Block

Choose whether to show just the CTA button or the full Bundle UI and customize the button color to match your store.

Click Save.

Display Options & Limitations

Each page supports one Bundle embed, meaning the full bundle builder can only appear once per template. You can also pair it with a CTA-only button that, when clicked, reveals the bundle experience without needing to link out or reload the page.

That said, Shopify gives you flexibility on where and how you present your bundle.

You can embed the full bundle directly on:

• A dedicated landing page (recommended for campaigns or email traffic)

• A product page (typically the parent product created for the bundle)

If you'd rather not display the full bundle immediately, you can:

• Add a CTA-only button that reveals the options upon click

• Place a CTA in your homepage or navigation, linking to a dedicated bundle page

• Use two CTA-only buttons on a page (for example, one at the top and one in the footer)

Preview your new Bundle Block

Switching from the legacy snippet?

If you previously used Smartrr’s code-based bundle implementation, or applied customizations to your theme for advanced styling or functionality, we recommend contacting Support before switching to the new App Block. This helps ensure that any bespoke storefront logic or visual adjustments carry over smoothly and nothing breaks.

📨 Email: [e-mail]

💬 In-app chat: Available via Smartrr admin

💻 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.