In Python, load the data with pandas and compute gross revenue retention from column totals for the whole period, or row by row for each month. On the sample data it returns 92.84.
GRR = (MRR at start − Contraction − Churned) ÷ MRR at start × 100
What you need
Gross revenue retention (GRR) is the share of starting recurring revenue still there at the end of a period, counting downgrades and cancellations but not upgrades. 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["grr"] = (df["mrr_start"] - df["mrr_contraction"] - df["mrr_churned"]) / df["mrr_start"] * 100
print(df[["month", "grr"]].round(2))
# Whole period: add up the parts first, then divide
grr_total = (df["mrr_start"].sum() - df["mrr_contraction"].sum() - df["mrr_churned"].sum()) / df["mrr_start"].sum() * 100
print(round(grr_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 | grr |
|---|---|---|---|---|
| 2026-01 | 1,80,000 | 3,500 | 9,000 | 93.06% |
| 2026-02 | 1,95,500 | 4,100 | 10,200 | 92.69% |
| 2026-03 | 2,12,900 | 3,900 | 11,800 | 92.63% |
| 2026-04 | 2,30,000 | 4,600 | 12,900 | 92.39% |
| 2026-05 | 2,41,400 | 4,200 | 12,100 | 93.25% |
| 2026-06 | 2,60,400 | 4,800 | 13,400 | 93.01% |
| Whole period | 13,20,200 | 25,100 | 69,400 | 92.84% |
(₹13,20,200 − ₹25,100 − ₹69,400) ÷ ₹13,20,200 × 100 = 92.84%
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 retention misleads
- Leave expansion out; including it gives NRR.
- Cap any single customer at their starting revenue, so an upgrade does not offset someone else's cancellation.
- Use the same period for both sides.
The full explanation, with a calculator, is on the Gross revenue retention (GRR) 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