Subscription status: set to renew, set to cancel and billing issue

The status_measure selector picks what is split: active subscriptions (the default), active trials, MRR or ARR. For each end-of-period snapshot, every subscription with access is counted, or valued, in exactly one of three states. Set to renew means it will renew at the end of the current period. Set to cancel means auto-renew is off and access ends at the end of the current period. Billing issue means the renewal failed and the subscription is in a grace period or billing retry.

RevenueDot keeps the store's current state, not a history of states. For the current period it uses that current state. For earlier periods it infers the state: a period that was followed by another paid period or a product change counts as set to renew, and a period that ended without renewing counts as set to cancel, or as billing issue if the store reported one. Read the latest bar for current risk, and treat older bars as an estimate.

The chart is a stacked bar of end-of-period snapshots. Sandbox purchases, granted access and Family Sharing purchases are excluded, and MRR and ARR use each subscription's purchase-date exchange rate. Filter or segment by app, store, product, product duration, offering, country, platform and app version.

Find it in the dashboard under Analytics > Charts, or call GET /v2/projects/{project_id}/charts/subscription_status with a selectors parameter such as {"status_measure":"mrr"}. The response has the same shape as RevenueCat's Charts API.

Illustrative numbers for the MRR measure at the end of one day.

$1,100 + $200 = $1,300 of the $10,500 MRR (about 12%) is set to cancel or has a billing issue.

A subscriber who turned off auto-renew is still counted today but will leave at the end of the paid period. This chart shows how much of your base is in that state now, which helps you forecast next month's MRR and decide whether a save offer or a cancellation survey is worth building.

The billing issue slice is money you can often keep. The store retries the charge during a grace period or billing retry, and a clear message in your app can recover it. If the slice grows after a release, check that your app still gives access while the store retries.

How to read it

• Read the newest bar for current risk. Earlier bars are inferred from what happened after them.
• Switch to MRR or ARR to weigh by money. A few annual plans set to cancel can outweigh many cheap monthly ones.
• Billing issue is not cancelled. The subscription has access and counts as active during a grace period.
• Set to cancel is not churn yet. The subscription churns when its paid time ends.
• With the trials measure, set to renew means auto-renew is on, so the trial will convert unless the customer turns it off.