Churn Recognition


You'll need to be an Admin or Owner in ChartMogul in order to update your Churn recognition setting. Read more about user roles and permissions.

There are two churn recognition options available for all ChartMogul customers and one specific to Recurly.  

Under Data Platform > Data settings > Subscription Analytics, there is a set of options titled Churn recognition.


  • Always recognize cancellations as churn at the end of the paid-up billing period — Churn will always happen at the end of the current paid-up subscription billing period, even if the subscription is canceled immediately in your billing system. This is often considered good practice for MRR reporting. One side effect (and a potential benefit) is that your MRR will usually appear to be higher with this setting.
  • Always recognize cancellations as churn at the time of cancellation — Churn will always happen in ChartMogul at the time the subscription is canceled/expired in your billing system. This gives you a more real-time view of your forward-looking MRR and is closer to the concept of Committed Monthly Recurring Revenue (CMRR).

Here's an illustration of how these options affect the date ChartMogul reports your customer has churned.


Suppose you set a subscription to cancel at the end of the period, or on a specific date in the future. In that case, ChartMogul will still recognize the cancellation when it actually happens (in the future) in your billing system, not the date when you configured the schedule.
  • Churn subscriptions at the time when the cancellation event is triggered/clicked, regardless if the subscription is set to cancel immediately or cancel/not renew at the end of the billing period — this option applies to data imported from Recurly only. For data from other data sources, cancellations will be recognized as churn at the time of cancellation. 

Changing your Churn recognition setting affects transactions going forward. To update historical transactions, you'll need to re-import your data.

The churn recognition setting applies to all integrations except for:

  • Google Play integration (via the Daily Sales Report)
  • App Store Connect integration

Due to limitations with these systems, ChartMogl recognizes cancellations at the end of the service period.

Was this article helpful?