Problem with catalog versioning: new Add-On not available for existing subscriptions

[Julia Nunes]

Hi Killbill team,

We’re facing an issue related to catalog versioning.

Here’s the scenario:

• We published an initial catalog version (let's call it v1) that includes a base product and add-ons.

• Later, we uploaded a new version of the catalog (v2), which introduces a new add-on product compatible with that same base product.

• Subscriptions created before v2 was published are tied to v1 and cannot see or purchase the new add-on from v2.

The problem:
Customers who subscribed while v1 was active are unable to purchase the new add-on, as it doesn’t exist in the version their subscription is linked to.

We understand this is expected behavior due to catalog immutability and versioning by effectiveDate. However, we’re looking for guidance on the best way to allow existing customers to access newly introduced add-ons.

Questions:

1. Is there any recommended way to “upgrade” a subscription to the latest catalog version so it recognizes new add-ons?

2. Are there known best practices for handling evolving product offerings without requiring subscription recreation?

Thanks in advance for your help!

[karan bansal]

Hi Julia,

Any changes to the catalog do not apply and are not available for the existing subscriptions. You will need to re-subscribe to the new plan.

Regards

Karan

[sh...@methodmaker.co.nz]

@karan bansal Are price changes an exception to this catalog versioning rule?