Skip to main content

What it is

lifecycle_stage is the stage an account occupies after its sale closes, expressed as one of eight ordered stages. Every account carries exactly one stage, and every other customer figure reads it rather than deriving its own. The stages run from the signed contract to long-term maturity. Stages before a deal closes belong to pipeline reporting and are not part of this value.

How it is calculated

Measured. The stage is set by the most recent recorded transition event, evaluated against the exit condition of the stage the account is in. A transition is recorded only at 70% confidence or above. Below that threshold the transition is flagged for review and the stage does not move. Typical stage durations differ by segment; the eight stages themselves do not.

Where it comes from

Where no customer-success platform is connected, Beacon builds the transition events from billing, contract and product events instead. Per-account stages appear once transition data has been flowing for 30 days; before that, only segment-level distributions exist.

How fresh it is

Transitions are recorded as they occur, so the stage changes at the moment a transition is confirmed rather than on a schedule. Lifecycle stage carries no monthly seal of its own; it anchors the renewal-forecast seal downstream. Accounts past 36 months of tenure are re-evaluated weekly.

Currency and rounding

Neither applies. Lifecycle stage is a category, not a number, and holds no money value.

What changes it

A transition event recorded at 70% confidence or above, which means the exit condition above has been satisfied. A backward move is possible and is recorded. A contract amendment that changes the renewal date moves the stage 4 and stage 5 boundaries with it. An administrative reclassification requires approval from your customer-success lead and is recorded with the previous stage, the new stage, the reason, the roles requesting and approving, and the timestamp. Score movements do not change the stage.

What it is not

  • Not a pipeline or marketing stage. Those cover the period before the deal closes and are owned by different reporting.
  • Not segment. Segment is the commercial group an account belongs to; stage is where the account has reached after the sale. Segment feeds stage evaluation through segment-typical durations. Stage never changes segment.
  • Not the cohort stage used in cohort reporting, which tracks whether a cohort is open, closing or closed.
  • Not the lifecycle-stage field in your CRM. That field is an input. Where the two disagree, the stage published here is the one every other Beacon figure reads.