Skip to main content

​
What it is

new_mrr is recurring revenue that started in the period from customers with no prior history. It is one of five movements, and the distinction that defines it is history rather than amount: a subscription that has never carried recurring revenue before is new. A customer who had revenue, went to zero and came back is not new — that is reactivation, and the two are kept apart deliberately, because a business winning genuinely new customers and a business winning back lapsed ones are in different positions. A cross-sell — a customer buying into a product family they did not previously own — is new recurring revenue, and it is published here rather than as a movement of its own. Being a cross-sell is a property of the movement, not a sixth movement.

​
The five movements

Every change in recurring revenue between one period and the next is exactly one of five movements, and the set is closed: Recurring revenue at the end of a period is recurring revenue at the start, plus new, expansion and reactivation, less contraction and churn. Because the five do not overlap and nothing falls between them, nothing is counted twice and nothing is lost. Each is published as the amount that moved. Which movement it is carries the direction; the figure does not. Revenue that did not move is not a movement. A customer paying the same as last period, and a customer who is inactive, are both baseline retained revenue. Neither is one of the five, and neither is published as one.

​
How it is calculated

Measured. A subscription with no recurring revenue before the period and recurring revenue above zero in it, where that subscription has no earlier history of recurring revenue, contributes its full recurring revenue to this figure. Every such subscription in the period is added together. Where more than one change lands on the same subscription inside a single period, the period’s net movement is classified once, on its net result.

​
Where it comes from

Billing invoice lines, and the history of the subscriptions behind them. Billing is the required connection, and subscription history is what separates this figure from reactivation — a billing system that cannot be read back far enough will report returning customers as new ones. Identity resolution matters here. Where a subsidiary is not resolved to its parent, its first purchase reads as a new customer rather than as expansion of one you already had.
No read interface or MCP tool serves this value yet — the table above publishes the shape ahead of the doors.
Where the choice is made. This value is not open by default on any door. The choice happens when a reader grant that reaches it is issued or widened, when you subscribe to events, or when you turn the CRM property on. Whoever makes it is shown who becomes able to see the value, and their yes is recorded — holding a grant is no longer enough on its own.

​
How fresh it is

How often this refreshes before a period closes is not declared, and that is stated rather than filled in. A figure’s refresh cadence is the cadence of the lock that freezes it, read at the part of Beacon that owns the figure; the movements live in Beacon’s shared core, which no single part owns, so there is nothing yet to read a cadence from. It will be filled in, not quietly. Once the period is closed the figure is fixed inside the locked record for that period, and a later correction is recorded as a named adjustment in the current period rather than restating a sealed one.

​
Currency and rounding

In your single reporting currency. It is an aggregate, so it travels with two facts rather than four — your reporting currency, and the kinds of anchor its components were pinned under, given as a list even when the list has one entry. It carries no single anchor date and no single billing currency, and that absence is stated rather than filled. Beacon applies no rounding of its own.

​
What changes it

A customer with no prior history starting to pay. A resolved identity, which can move a purchase out of this figure and into expansion of the parent. A correction to an invoice line in the period. It is not changed by anything that happens to customers you already had.

​
What it is not

  • Not reactivation_mrr. Same shape — zero to positive — different history. The subscription’s past decides which one it is.
  • Not a count of customers won. It is an amount of revenue; two periods with the same number of new customers can carry very different figures here.
  • Not bookings or contract value. It is the recurring run rate that started, not what was signed.
  • Not part of net revenue retention or gross revenue retention. Both read the customers you already had; new business is excluded from them by construction.
  • Not a forecast of what you will win.