Handling paused subscriptions in ChartMogul

ChartMogul does not offer native support for paused subscriptions. In this article, we explain how ChartMogul handles paused subscriptions for select billing systems and how to include or exclude these subscriptions from your ChartMogul reports.


When a subscription is paused in Recurly, ChartMogul cancels the subscription at the end of the current service period and creates a new subscription once it is resumed. During this time, the subscription will not contribute to MRR.

Stripe, GoCardless, and Chargebee

When a subscription is paused in any of these billing systems, the customer status is set to Past due at the end of the current service period. The subscription continues to generate MRR during this time.

Managing paused subscriptions

Here are some ways you can set up ChartMogul to filter and segment these subscriptions for more accurate reporting.

  1. Create custom attributes or tags to identify customers whose subscriptions are currently paused. This will allow you to filter out these customers from your reports or create a new segment for paused subscriptions. Depending on your billing system, these subscriptions may or may not contribute to your total MRR.

    Screenshot of a customer record's Tags section with one tag, paused_subscription


  2. Add a plan for paused subscriptions and use this when a customer moves from a paid subscription to a paused subscription. This will allow you to easily filter the subscriptions using the paused plan you created. Customers under this plan will be reported as Active in ChartMogul but will not contribute to MRR. 
  3. If you import billing data using the API, move customers to a 100% discount or send a $0 invoice. Use this option if you don't want paused subscriptions to contribute to MRR but want to report these subscriptions as Active. You can then filter your paused customers by querying active customers that have $0 of MRR.

    If you choose this option, we recommend reviewing the Free Customer Handling setting, as it determines if the customer churns or stays active in ChartMogul.

Was this article helpful?

We’re sorry to hear that. Would you like to share more feedback?

Thanks for your feedback!