Add-On
Add-Ons let you extend your plans with optional features or capacity that customers can purchase on demand. They are versioned and consist of one or more rate cards defining pricing, entitlements, and billing cadence independently of the base plan.
What is an Add-On?
An Add-On is a standalone item in your product catalog that can be attached to a plan. It allows you to upsell extra features, overage packs, or services without changing the core plan.
Add-On Use Cases
Add-ons are a great way to bundle or cross-sell products on top of your base plans or extend the usage limits of existing features while keeping the base price low.
- Enable new features: Add-ons can enable new features that are not available in the base plan.
- Extend usage limits: Of existing features: Add-ons can extend the usage limits of existing features.
- Cross-sell or bundle products: Add-ons can add new rate cards and prices.
Add-On Composition
An Add-On is composed of one or more rate cards, each defining a specific feature, its pricing, billing cadence, and entitlements. This modular approach lets you mix and match features and capacities independently of your base plans.
Add-Ons can be either:
- Single-instance: only one per subscription allowed
- Multi-instance: multiple per subscription allowed
Read more about how add-ons work in the add-on subscription documentation.
Add-On Compatibility
Compatibility between add-ons and plans is managed through the plan versioning cycle:
- Draft Version: You can add or remove add-ons freely before publishing.
- Published Version: The set of add-ons is locked and available to new subscriptions.
When assigning an add-on to a plan, you can choose how many instances of the
add-on are allowed per subscription, and at which phase of the plan the add-on
is available (startingPhase).
Once a plan version is published, add-on compatibility cannot be changed.
OpenMeter imposes some limitations on the compatibility of add-ons and plans:
- Due to billing alignment requirements, the billing cadences of the add-on must match the plan's billing cadence.
- Any Rate Cards present in both the add-on and the plan must meet extendability rules.