In Python, load the data with pandas and compute gross revenue churn rate from column totals for the whole period, or row by row for each month. On the sample data it returns 7.16.
Gross revenue churn = (Contraction MRR + Churned MRR) ÷ MRR at start × 100
What you need
Gross revenue churn rate (or gross MRR churn) is the share of recurring revenue lost in a period through cancellations and downgrades, as a percentage of revenue at the start. You need these columns, here from the sample file monthly.csv:
- df["mrr_start"]: MRR at start of month
- df["mrr_contraction"]: contraction MRR
- df["mrr_churned"]: churned MRR
Step by step
- Install pandas (pip install pandas) and save monthly.csv next to your script.
- Run the script. The first print shows one row per month, the second the figure for the whole period.
- To use your own data, rename your columns to match, or change the names in the code.
The code
import pandas as pd
df = pd.read_csv("monthly.csv")
# Each month
df["gross_revenue_churn"] = (df["mrr_contraction"] + df["mrr_churned"]) / df["mrr_start"] * 100
print(df[["month", "gross_revenue_churn"]].round(2))
# Whole period: add up the parts first, then divide
gross_revenue_churn_total = (df["mrr_contraction"].sum() + df["mrr_churned"].sum()) / df["mrr_start"].sum() * 100
print(round(gross_revenue_churn_total, 2))
What you should get
Run against the sample data, the code above returns these values (in percent):
| Month | mrr_start | mrr_contraction | mrr_churned | gross_revenue_churn |
|---|---|---|---|---|
| 2026-01 | 1,80,000 | 3,500 | 9,000 | 6.94% |
| 2026-02 | 1,95,500 | 4,100 | 10,200 | 7.31% |
| 2026-03 | 2,12,900 | 3,900 | 11,800 | 7.37% |
| 2026-04 | 2,30,000 | 4,600 | 12,900 | 7.61% |
| 2026-05 | 2,41,400 | 4,200 | 12,100 | 6.75% |
| 2026-06 | 2,60,400 | 4,800 | 13,400 | 6.99% |
| Whole period | 13,20,200 | 25,100 | 69,400 | 7.16% |
(₹25,100 + ₹69,400) ÷ ₹13,20,200 × 100 = 7.16%
Notes for Python
- Dividing by zero in pandas does not raise an error: it gives inf or NaN. Check with df.replace([float("inf"), -float("inf")], float("nan")) before averaging or plotting.
- For the whole period, sum the columns first and then divide. df[col].mean() of the monthly results weights a small month the same as a large one.
- pct_change(), groupby() and resample() extend the same idea to weekly data, product categories and daily rows.
Where gross revenue churn rate misleads
- Gross churn ignores expansion. Use net revenue retention to include it.
- Exclude new customers who joined during the period from the starting MRR.
- A pause feature can hide churn as contraction. Decide how paused subscriptions are counted.
The full explanation, with a calculator, is on the Gross revenue churn rate page.
Same metric, other tools
Related metrics in Python (pandas)
Learn more about Python
- Python and SQL for data analysis, side by side — 3 min read
- How to find out what changed in your sales data — 2 min read
About the data on this page
The figures come from a small made-up dataset, printed above in full so you can check every number by hand. Download it as monthly.csv. The results are computed from those rows when the page is built, and the Excel formulas, SQL and Python on these pages are run against the same rows before publishing, so the code and the answers agree.
To get these numbers from your own data without writing formulas, try AnalyzeIt: ask in plain words and it shows the working behind every figure.
Legal entity
Devansh Yadav
Moradabad, Uttar Pradesh
Governing law: Courts at Moradabad, Uttar Pradesh
Phone: +91 8433475698
Legal: legal@analyzeit.in