Linked subscriptions

This feature applies to subscriptions with multiple components.

A Linked subscription is a subscription that was replaced by another subscription in the same subscription set — ChartMogul uses this status to treat the change as a plan switch rather than a churn and reactivation.

Screenshot with two subscriptions: Enterprise Plan with status Active, followed by a Gold Plan Monthly with status Linked. The Gold Plan is subordinate to the Enterprise Plan.

A subscription is Linked when it’s part of a subscription set and is replaced by another subscription. ChartMogul would typically classify the MRR movements for this change as Churn followed by Reactivation. However, with Linked subscriptions, we treat the change as if the customer had switched plans and classify the MRR movements as either Expansion or Contraction, as the case may be.

Read more about how ChartMogul organizes and classifies MRR movements.

When ChartMogul Links Two Subscriptions

ChartMogul links two subscriptions when both of these conditions are true:

Both subscriptions have the same Subscription Set ID
One of the subscriptions ends just before the other begins

Linking happens automatically and can't be undone.

For example, a customer in Stripe replaces one subscription item with another. ChartMogul represents each Stripe subscription item as its own subscription, and uses the Stripe Subscription ID as the Subscription Set ID. ChartMogul then links the removed subscription to the new one and treats them as a single continuous subscription — similar to a connected subscription.

If a customer replaces one subscription with two subscriptions in the same set, ChartMogul can't automatically link the old subscription — there are multiple candidates and no clear match. You'll need to connect these subscriptions manually.

Read more about subscriptions with multiple components.