Selling Plan Integration

Rich Landing Bundle – Subscription Support Overview

Rich Landing Bundle integrates with Shopify's Selling Plans API to let you sell bundles as recurring subscriptions. When enableSubscription is turned on for a bundle, the widget:

1. Fetches selling plan groups from the Storefront API for the products in the bundle
2. Displays subscription options (e.g., “Subscribe & Save — Delivered every month”)
3. Stores the selected selling plan ID on the cart line item
4. Lets Shopify handle subscription creation at checkout using that selling plan ID

Selling Plans in Shopify

Selling Plans are Shopify’s native system for recurring purchases. They define:

• Delivery frequency – how often the subscription ships (e.g., every 30 days)
• Billing frequency – how often the customer is charged
• Pricing adjustments – optional subscriber discounts (e.g., 10% off for subscribe-and-save)
• Plan groups – collections of related plans (e.g., a “Subscribe & Save” group with monthly and bi-monthly options)

Selling Plans are created and managed by subscription apps such as:

• Shopify Subscriptions
• ReCharge
• Bold Subscriptions
• Loop

Rich Landing Bundle does not create selling plans. It only reads existing selling plans from your products and surfaces them in the bundle widget.

How It Works with Bundles

When enableSubscription is enabled on a bundle:

1. Widget fetches selling plans

The widget queries the Storefront API for selling plan groups that are available on the products included in the bundle.

1. Plans are displayed

Customers see subscription options (e.g., “Subscribe & Save — Delivered every month”) alongside product selections in the bundle widget.

1. Selection is stored

When a customer chooses a subscription option, the selected selling plan ID is attached to the cart line item (e.g., via attributes or sellingPlanId).

1. Checkout processes normally

Shopify’s checkout uses the selling plan ID to create and manage the subscription. The bundle itself behaves like a normal subscription line item from Shopify’s perspective.

Prerequisites

Before enabling subscription support on a bundle, you must:

1. Install a subscription app

Use a Shopify subscription app that can create selling plans, such as Shopify Subscriptions, ReCharge, or Loop.

1. Create selling plan groups

In your subscription app, configure at least one selling plan group (e.g., “Subscribe & Save – 10% off”).

1. Assign plans to products

Ensure the products used in your bundle have selling plans assigned to them in Shopify.

1. Storefront API access

Confirm your Storefront API token has permission to read selling plans. Rich Landing Bundle configures this automatically when installed, but it must remain enabled.

Widget Display Behavior

When subscription support is enabled and valid selling plans are found, the bundle widget shows:

• A toggle or selector to choose between one-time purchase and subscription
• Available subscription frequencies from the selling plan group (e.g., every 30 days, every 60 days)
• Subscription-specific pricing, such as “Save 10% when you subscribe”
• The selected plan name in the bundle summary box

Tip: If no selling plans are available for the bundle’s products, the widget automatically hides subscription options and behaves as a one-time purchase bundle without showing an error.

Compatibility

Subscription bundles are compatible with:

• All discount types – Percentage, fixed amount, and gift tier discounts all work with subscription bundles.
• Cart transform – Expanded bundles preserve the selling plan ID through to checkout.
• Multi-step bundles – Each step can contain products with different selling plans; the widget uses the common selling plan group across those products.
• Markets – Selling plans respect Shopify Markets and any market-specific pricing.