Add-Ons
Purchasing Add-Ons
For a running Subscription, extra Add-Ons can be purchased that are compatible with the Subscriptions underlying plan. Purchising Add-Ons for custom subscriptions is not possible.
If a Subscription has Add-Ons associated with it, editing the Subscription is no longer supported.
When an Add-On is purchased, its contents are combined with the Subscription's existing items.
- If a RateCard is not present in the Subscription, only the Add-On, the RateCard is added to the Subscription as a new Item.
- If a RateCard is already present in the Subscription, the existing item will be extended with the contents of the Add-On's RateCard.
The resulting items will keep the Subscription's alignment and billing cadence.
Extendability
When an Add-On extends an existing Subscription Item, their properties are merged:
static prices
are merged by summing them up.boolean entitlements
are merged into a single boolean entitlement.metered entitlements
are merged by summing theirissueAfterReset
if all other properties match.usage discounts
are concatenated as a list.
Combinations not listed above are either non-effectual or will result in validation errors during the compatibility checks. The list of compatible combinations will grow in time, but the default behavior of creating new Subscription Items already makes this a versatile toolkit: in general, it is encouraged to break the contents of an Add-On into multiple RateCards.