> ## Documentation Index
> Fetch the complete documentation index at: https://docs.beaconrevenue.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Net revenue retention

> Recurring revenue kept from customers you already had, after expansion, contraction and churn, excluding new business.

## What it is

`net_revenue_retention` is the share of recurring revenue kept from the customers you already had at the start of a period, after expansion, contraction and churn within that group. Revenue from customers won or won back during the period is excluded. A result above 100% means expansion within the existing base outweighed what was lost.

## How it is calculated

Measured.

```text theme={null}
net_revenue_retention =
  (starting recurring revenue - churned - contracted + expanded)
  / starting recurring revenue
```

| Term                       | Meaning                                                                                          |
| -------------------------- | ------------------------------------------------------------------------------------------------ |
| Starting recurring revenue | Recurring revenue of the customers active on the first day of the period                         |
| Expanded                   | The increase, where recurring revenue rose and both the earlier and later figures are above zero |
| Contracted                 | The decrease, where recurring revenue fell but stayed above zero                                 |
| Churned                    | The full amount, where recurring revenue fell to zero                                            |
| Excluded                   | New customers and returning customers, which are net-new business rather than retention          |

Only recurring lines count. One-off charges — onboarding, professional services, training, setup, milestone payments — are excluded. The period can be a month, a quarter, a fiscal year, or the trailing twelve months.

## Where it comes from

Billing invoice lines. Each line becomes a monthly recurring figure by dividing its total across its service period, so a line without a service period is raised as a data issue rather than counted. Values typed into a CRM or a billing tool as a monthly or annual figure are not used.

Identity resolution matters to this figure more than to most: where a subsidiary is not resolved to its parent, its growth counts as a new customer rather than as expansion, and expansion is inside the calculation while new business is outside it.

## How fresh it is

Republished continuously, within 60 minutes of a change at source, and sealed at each monthly close. The quarterly close seals the three monthly seals together. Monthly close runs in a 5-business-day window, quarterly in 10. A correction arriving after a seal — a backdated invoice, a retroactive amendment, a late-recorded churn — is recorded as a named adjustment in the current period. A sealed figure is never quietly restated.

## Currency and rounding

Each company reports in one currency. Transactions in other currencies are converted at their own rate before any total is formed, and both the original and the converted value are kept. Net revenue retention is a ratio of two revenue figures, so it carries no currency of its own.

## What changes it

Expansion, contraction and churn among the customers who were active at the start of the period. New and returning customers do not change it. A resolved identity can change it by reclassifying a subsidiary's growth from new business to expansion. A post-close correction changes the current period rather than the sealed one.

## What it is not

* Not gross revenue retention. That is the same calculation without the expansion term, and it cannot exceed 100%.
* Not logo churn. That counts customers lost against customers held, not revenue.
* Not a forecast. This is the figure for a period that has been measured; the forecast of it is a separate value.
* Not a measure of growth. New business is excluded by construction.