Reference
Net Revenue Retention Definition
Learn the governed definition of Net Revenue Retention, including NRR cohort rules, expansion, contraction, churn treatment, and ClariLayer Drift Risk.
Metric 3 of 16
Retention
Net Revenue Retention
Net Revenue Retention measures how much recurring revenue a starting cohort keeps after expansion, contraction, and churn over a defined period, before adding revenue from new customers outside that starting cohort.
Governed formula
(starting cohort recurring revenue + expansion - contraction - churn) / starting cohort recurring revenue
- Use the same cohort, currency, product filter, and recurring revenue basis for the numerator and denominator.
- Exclude new-customer recurring revenue that was not present in the starting cohort.
Account-cohort NRR
Builds the cohort from accounts active at the start of the period and follows those accounts through expansion, contraction, and churn.
Useful for customer-base health, but it needs account hierarchy and merger treatment to be explicit.
Subscription-cohort NRR
Builds the cohort from subscriptions active at the start of the period and follows subscription-level changes.
Useful for product-line analysis, but it may miss account-level expansion across related subscriptions.
Logo-excluded NRR
Keeps reactivated or acquired logos out of the cohort unless they existed at the start of the period.
Useful for strict retention analysis, but it requires a governed reactivation and acquisition policy.
Decisions to lock
What creates the starting cohort: accounts, subscriptions, products, or contracts?
Cohort grain controls which expansions and contractions are counted as retained revenue.
How are reactivations, account merges, acquisitions, and product migrations treated?
Those events can move revenue in or out of the cohort unless they have explicit treatment.
Which recurring revenue basis powers NRR: ARR, MRR, booked value, or live value?
NRR inherits the definition risk of the revenue basis used in both the starting and ending amounts.
Validation questions
- Can each NRR movement be traced back to a starting-cohort account or subscription?
- Do expansion, contraction, and churn movements reconcile to the same recurring revenue basis?
- Are reactivations, account merges, product migrations, and acquired accounts classified before the ratio is calculated?
Common drift traps
- New customers are accidentally included in the numerator because the ending-period query does not restrict to the starting cohort.
- Expansion uses booked ARR while contraction and churn use live MRR, producing a ratio that mixes definitions.
- Account hierarchy changes make a retained parent account look like churn at a child account level.
Source-system boundary
Retention cohort spine
Billing platform, Contracts, CRM, Customer success platform, Data warehouse
The governed definition should state cohort grain, start population, movement events, account hierarchy, and revenue basis.
Context-layer proof
ClariLayer's context layer should attach NRR to its cohort grain, starting population, revenue basis, and movement taxonomy so every retention answer can show which revenue stayed, expanded, contracted, or churned.
- Governed signals
- cohort grain, starting population, revenue basis, movement taxonomy
- Review cadence
- Review after account-hierarchy, pricing, packaging, renewal-process, or customer-success-system changes.
ClariLayer Drift Risk
NRR is high risk because it combines revenue definitions, cohort logic, and movement taxonomy into one ratio that often travels without its assumptions.
Ambiguity
5/5NRR can vary by cohort grain, revenue basis, reactivation treatment, and whether new-customer revenue is excluded correctly.
Source-system dependency
5/5The calculation depends on billing, contract, CRM, account hierarchy, success, and warehouse movement records.
Time-window sensitivity
5/5Start and end dates define the cohort, the movements, and the retained revenue, so small window changes can alter the ratio.
Governance need
5/5NRR is used in executive retention reviews and needs explicit owner approval for cohort and movement rules.
AI-agent risk
An AI agent summarizing retention can produce a confident but wrong answer if it cannot see the cohort grain, revenue basis, and movement classification that created the NRR figure.