MRR movement: new, expansion, churned and contraction MRR

Each part is a monthly value in US dollars, counted on the date the change happened. New MRR is the monthly value of subscriptions that became paid, other than resubscriptions and product changes. A free trial adds to New MRR on the day it converts. Resubscription MRR is the value of subscriptions started by customers whose earlier subscription had ended. Expansion MRR is the increase from a product change or a renewal at a higher monthly value. Contraction MRR is the decrease from a product change or a renewal at a lower monthly value.

Churned MRR is the monthly value lost when a paid subscription ended, and it is net of billing recoveries. If a renewal fails, access lapses, and the store later recovers the payment, the recovery cancels the earlier churn. A paid-to-paid product change is counted once, as a net expansion or contraction, and not as churn plus a new subscription.

The movement row is the sum of the five parts. It is in the table and the API, and it is not drawn in the chart. Sandbox purchases, granted access and Family Sharing purchases are excluded, and each subscription keeps the exchange rate of its purchase date. 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/mrr_movement. The response has the same shape as RevenueCat's Charts API. The default resolution is day, and week, month, quarter and year are available.

Illustrative numbers for one month, starting at $10,000 of MRR.

Movement = 1,200 + 150 + 300 − 900 − 100 = +$650, so MRR ends the month at $10,650.

MRR tells you where you are. MRR movement tells you why. If MRR is flat, the bars show whether nothing happened or whether new MRR and churned MRR cancelled each other, and those two situations need very different fixes.

Big new MRR with big churned MRR points to a retention problem or a weak first renewal. Strong resubscription MRR means win-back works. Strong expansion MRR means customers move to higher plans. Check it after every paywall, pricing or onboarding change.

How to read it

• Churned and contraction MRR are negative, so they plot below zero in the stacked bars.
• The net movement equals the change in MRR over the period. If the bars and the MRR line disagree, check that both use the same filters.
• A switch from a monthly plan to an annual plan is one expansion or contraction, not churn plus a new subscription.
• A free trial adds nothing until it converts, so trial starts do not appear here.
• A failed renewal that the store recovers later shows churn in one period and an offsetting recovery after it.