🧱Bundle App Block

Last updated: Jun 24, 2025

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.

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.

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.

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.

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.

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.

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

Copy and paste your Bundle ID from Smartrr

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)

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: [email protected]

💬 In-app chat: Available via Smartrr admin

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:

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.