Bundle Builder: Switch to Subscription

Switch to Subscription lets a shopper buy an entire Bundle Builder bundle on a recurring delivery schedule instead of as a one-time purchase. Use this article to turn the setting on, decide whether the bundle offers a one-time option alongside the subscription option, control how the delivery interval list is built, decide whether the bundle discount applies to subscription orders, and write the labels shoppers see.

Switch to Subscription in Bundle Builder depends on two things being in place, and the toggle will not produce a subscription option on the storefront without both.

Your store needs a subscription app that uses Shopify selling plans, connected through Integrations > Subscriptions Integration in Rebuy Admin. Bundle Builder builds its delivery interval list entirely from the selling plans attached to the products in the bundle, so a store with no selling plan data has no intervals to offer and the subscription option stays disabled. Setup steps are in Enabling Subscription Integrations.

The bundle's Discount Mechanism also needs to be set to Shopify Functions, in the Bundle Builder editor's Discounting sidebar. Under the Cart Transforms mechanism the Switch to Subscription toggle is greyed out and carries the tooltip Switch to Subscription for the entire bundle isn't available when using Cart Transform API Discount Mechanism in General Discounting, and the subscription option does not render on the storefront.

To offer a bundle as a subscription, turn on the Switch to Subscription toggle in the Bundle Builder editor. Bundle Builder lives under Cart & Merchandising > Bundles in Rebuy Admin, where the Your Bundles table lists every bundle on the store with its name, ID, and type.

When the save succeeds, reload your bundle page on the storefront and add a product to the bundle. A Sub & Save option and a One-Time order option appear in the bundle container above the Add Bundle To Cart button.

If the save fails, Rebuy Admin shows the specific field that is empty, such as Subscription is enabled, but no Save Label language within General Settings. Fill in the named field and save again. If the save succeeds but no subscription option appears on the storefront, the products in the bundle have no selling plans attached: check that your subscription app is connected under Integrations > Subscriptions Integration, then resync selling plans from Settings > Status.

Subscription Type is the radio setting directly under the Switch to Subscription toggle in the Bundle Builder General tab, and it decides whether shoppers can still buy the bundle as a one-time order.

Bundle Subscription is the default Subscription Type in the Bundle Builder General tab, and it gives the shopper a choice between subscribing and buying once. The bundle container shows a Sub & Save option and a One-Time order option, with One-Time order selected when the page loads. Every product your steps return stays available, whether or not it has a subscription plan. If a shopper builds a bundle where no product carries a selling plan, Bundle Subscription falls back to the one-time option and the subscription option is disabled.

Subscription-Only Products is the other Subscription Type in the Bundle Builder General tab, and it makes the bundle subscription-only. Bundle Builder filters every step down to products that have a subscription plan attached, so products without a selling plan never appear in the bundle at all. The one-time option is removed from the bundle container and the subscription option is selected from the moment the page loads. Because the one-time fallback is gone, a Subscription-Only Products bundle whose steps return no subscription products leaves the shopper with no way to add the bundle to the cart, so confirm your step data sources return subscription products before setting this option.

The delivery interval dropdown that appears next to the subscription option is built from the products currently in the shopper's bundle container, not from your Bundle Builder settings, and it updates every time the shopper adds or removes a product.

Bundle Builder collects the intervals from every product in the bundle and offers the combined list. An interval offered by only one product in the bundle still appears in the dropdown. When the shopper adds the bundle to the cart, each product is matched to its own selling plan for the chosen interval. A product that has no plan matching the chosen interval is added on its first available selling plan instead, so it still becomes a subscription line but on its own schedule. To keep every product in a bundle on the same schedule, give every product your steps can return the same set of selling plan intervals in your subscription app.

Once the shopper empties the bundle container, the selected interval clears. If every product is removed and the bundle no longer has any selling plans to draw from, the purchase type resets to one-time, unless Subscription Type is set to Subscription-Only Products.

Subscription Data Aggregate Key is the dropdown under Configure in the Bundle Builder General tab, and it tells Bundle Builder where to read interval names from when a product's variant does not expose selling plans directly. It has two options, value and name, and the default is value.

Most subscription apps attach selling plans to the product variant. When Bundle Builder finds selling plans on the variant it reads the interval names straight from those plans and Subscription Data Aggregate Key has no effect at all.

The setting matters for apps that expose selling plan groups without variant-level plans, such as Appstle. Set Subscription Data Aggregate Key to value to read the intervals from the selling plan group's option values, which is the right choice when your app stores the frequency as the option value, for example Every 30 days. Set it to name to read the intervals from the selling plan names inside the group instead, which is the right choice when your app stores the frequency in the plan name. If the interval dropdown on the storefront shows the wrong wording or shows nothing at all while your products clearly have subscription plans, switch this setting to the other option and test again.

Excluded Bundle Discount is the checkbox under Configure in the Bundle Builder General tab, and it stops the bundle's tier discount from stacking on top of the subscription discount. It is unchecked by default, which means a shopper who subscribes gets both the bundle tier discount and the subscription discount their selling plan carries.

Check Excluded Bundle Discount to hold the bundle tier discount back from subscription orders. The subscription price the shopper sees in the bundle container then reflects only the selling plan discount, and the setting is written into the Shopify Functions discount configuration for the bundle, so the tier discount is withheld at checkout too and not only in the display. Shoppers who pick the one-time option still receive the bundle tier discount in full.

Checking Excluded Bundle Discount removes the bundle's subscription lines from the tier calculation as well as from the discount, so a subscription bundle does not count toward a quantity or subtotal threshold and reaches no tier at all. The progress bar still fills as the shopper builds the bundle, and the saving lands only if they choose the one-time option.

When Excluded Bundle Discount is checked, the text in Exclusion Bundle Discount Label appears under the subscription option so shoppers understand why the bundle discount is missing from that price. That label defaults to Choosing Subscribe & Save? Progress bar discounts only applies to one-time purchases. and is worth rewriting to match your own offer.

The bundle tier discount applies to the checkout the shopper completes. Recurring orders on the selling plan are priced by the Shopify subscription contract instead, so the saving a subscriber keeps seeing on later deliveries is the one configured in your subscription app, not the Bundle Builder tier discount.

Rebuy builds the bundle tier discount as a Shopify Function that runs against the cart at checkout and identifies bundle lines by the cart attributes Bundle Builder writes when the shopper adds the bundle. A recurring order is generated from the subscription contract rather than from a cart, so neither those attributes nor that function take part in pricing it. If you want the saving to continue past the first order, set the ongoing subscriber discount on the selling plan in your subscription app.

Every piece of text in the subscription section of the bundle container is editable in the Bundle Builder General tab, in the fields that appear under the Switch to Subscription toggle. The table below lists each field, the text it ships with, and whether Rebuy Admin will block a save when it is left empty.

Save Label sits next to the savings percentage on the subscription option, so it reads as a phrase leading into a number, for example Save 15%. Subscribe & Save Title and One Time Bundle Label are the labels on the two radio options themselves. Subscribe & Save Description and One Time Bundle Description are the smaller lines of supporting text under each option, and both are hidden when left empty. Exclusion Bundle Discount Label appears only when Excluded Bundle Discount is checked.

Leaving Save Label, Subscribe & Save Title, or One Time Bundle Label empty while Switch to Subscription is on blocks the save with a message naming the missing field.

Switch to Subscription in Bundle Builder applies to the bundle as a whole, and these constraints follow from that.