Docs

Log into read the version of docs relevant to your site.

    Overview

    Chargebee allows merchants to create Product Bundles, grouping multiple items into a single plan offering. Bundles are treated as an item in the system and can be used when creating a new plan.

    Who is this for?

    This feature is designed for merchants who want to offer combined product offerings with unified pricing and entitlements.

    Key Concepts

    Bundle Plan vs. Individual Plan

    When creating a new plan, you can choose between:

    • Individual Plan – A standard plan with standalone pricing and entitlements.
    • Bundle Plan – A combination of multiple items offered as a single unit.

    Unified Pricing

    • Bundles have a single unified price at the subscription level.
    • The prices of individual items within the bundle do not affect the bundle's overall price.

    Price Points

    • Price points can be defined for specific frequency and currency combinations.
    • Each item in the bundle must have defined price points for the selected frequency and currency.

    Entitlements in Bundles

    Automatic Inheritance

    When creating a bundle, all entitlements from included items are automatically inherited by the bundle.

    Example

    • Plan: Basic (10 reports)
    • Add-on: Basic (20 reports) + AI Bot

    Bundle Total Entitlement = 30 reports + AI Bot

    Entitlement Priority Rules

    If an item has entitlements defined at both the item level and the item price level, the item price-level entitlements take precedence.

    Example

    • Plan A: 10 reports (item level), 20 reports (monthly price level)
    • Plan B: 20 reports (item level)

    Bundle (monthly) = 20 (Plan A) + 20 (Plan B) = 40 reports

    Upgrades and Downgrades

    Entitlements will update to reflect upgrades or downgrades in bundle items, replicating standard item behavior.

    Subscription-Level Overrides

    Any entitlement or configuration override made at the subscription level will take precedence over both item-level and bundle-level settings.

    Limitations

    1. Bundling is not supported with grandfathering entitlements.
    2. Bundling is not supported if there are separate entitlements set at variant level.
    3. Overriding entitlements at the bundle level is currently not supported but planned.

    Was this article helpful?