Reference
Gross Revenue Retention Definition
Learn the governed definition of Gross Revenue Retention, including GRR cohorts, contraction, churn boundaries, movement rules, and ClariLayer Drift Risk.
Metric 6 of 16
Retention
Gross Revenue Retention
Gross Revenue Retention measures how much recurring revenue a starting customer cohort keeps after churn and contraction, before any expansion offsets are added back into the result.
Governed formula
(starting cohort recurring revenue - contraction - churn) / starting cohort recurring revenue
- Use one recurring revenue basis for starting revenue, contraction, and churn.
- Exclude expansion from the numerator so the metric shows downside retention pressure.
Account-cohort GRR
Follows accounts active at the start of the period and measures retained recurring revenue after losses.
Useful for customer-base durability, but account hierarchy changes need explicit treatment.
Subscription-cohort GRR
Follows subscriptions active at the start of the period instead of rolling movement to the account level.
Useful for product-line analysis, but it can miss offsetting changes across related subscriptions.
Product-filtered GRR
Limits the starting cohort and loss movements to approved recurring products or packages.
Useful when packaging changes, but it requires versioned product filters to keep history explainable.
Decisions to lock
Which starting cohort grain and recurring revenue basis define GRR?
GRR inherits the cohort and revenue-basis decisions behind ARR, MRR, and retention movements.
Which movements count as contraction versus full churn?
The numerator depends on loss classification, especially for downgrades, cancellations, and product migrations.
How are reactivations, account merges, and partial-period losses handled?
Edge cases can move retained revenue between periods or remove prior losses without a visible rule.
Validation questions
- Can every contraction and churn amount be traced to a starting-cohort customer or subscription?
- Does GRR exclude expansion even when the same account expands in the measurement period?
- Are downgrades, product migrations, and reactivations classified before the ratio is calculated?
Common drift traps
- Expansion is netted into the numerator, causing GRR to behave like NRR under a different label.
- Contraction uses subscription events while churn uses CRM account status, creating movement totals that do not reconcile.
- Product migrations are recorded as contraction in one system and retained revenue in another without a governed bridge.
Source-system boundary
Gross retention movement spine
Billing platform, Contracts, CRM, Customer success platform, Data warehouse
The governed definition should state cohort grain, recurring revenue basis, movement taxonomy, and account hierarchy handling.
Context-layer proof
ClariLayer's context layer should bind GRR to the approved cohort grain, recurring revenue basis, loss taxonomy, and expansion exclusion rule so retention conversations separate downside pressure from expansion strength.
- Governed signals
- cohort grain, recurring revenue basis, loss movement taxonomy, expansion exclusion rule
- Review cadence
- Review after packaging, renewal-process, billing-state, or account-hierarchy changes.
ClariLayer Drift Risk
GRR is high risk because it looks close to NRR while answering a different question about downside retention before expansion offsets.
Ambiguity
5/5GRR changes meaning when teams vary the cohort grain, revenue basis, loss taxonomy, or expansion exclusion rule.
Source-system dependency
5/5The metric depends on billing movements, contracts, CRM hierarchy, success records, and warehouse cohort logic.
Time-window sensitivity
4/5Start and end dates decide the cohort and loss movements, while reactivations can alter retained revenue timing.
Governance need
5/5GRR informs retention and customer-success action, so the exclusion of expansion and loss rules need owner approval.
AI-agent risk
An AI agent can misread GRR as net retention if the context layer does not expose that expansion is excluded and the loss movements come only from the starting cohort.