Skip to content
Bookings
Contracted Users

Total Contracted Users

The end-of-period count of all active contracted user seats or licenses across your entire customer base.

Count

Formula

Contracted Users=Starting Users+New Users+Expansion UsersDowngrade UsersChurned Users\text{Contracted Users} = \text{Starting Users} + \text{New Users} + \text{Expansion Users} - \text{Downgrade Users} - \text{Churned Users}
Contracted user seats at period start New seats from newly signed customer contracts Seats added when existing customers upsize their contractsSeats removed when existing customers downsize Seats lost to fully churned customer contracts

Built from

What it measures

A point-in-time count of every active contracted user seat or license as of the last day of the period. It includes all seats tied to active customer contracts regardless of plan tier, usage level, or geography. One seat under one contract counts once; the same person seated under two separate customer contracts counts twice — once per contract. Seats on expired, churned, or inactive contracts are excluded.

Why it matters

Total Contracted Users is how you size and pace your contractual user base. Where ARR tells you revenue scale, this metric tells you reach and adoption breadth. Investors read it for market penetration: a land-and-expand business with slow seat growth but fast ARR growth is mining a small base, while fast seat growth and slower ARR growth means you're winning logos at lower entry prices. Operators use it to forecast customer-success demand, set hiring and capacity plans, and catch when churn or downgrades start eroding the seat base beneath your revenue.

How to read it

Read Total Contracted Users as a trend, never a single snapshot — compare this period to the last and to plan. Movement comes from four levers: new seats and expansion seats pushing up, churned seats and downgrades pulling down. If the seat count grows 10% but new bookings add only 5%, the other 5% is expansion inside existing customers — a strong retention signal. If it grows while churn accelerates, new bookings are masking a leak. Always pair seat-count growth with Contracted User Churn and Net Revenue Retention to see whether the base is healthy or bleeding from the high-value end.

What good looks like

Good

Total Contracted Users grows every period because new bookings and expansion seats outpace churn and downgrades, with growth balanced across plan tiers rather than concentrated in low-value seats.

Watch

Seat growth is slowing or flat despite continued new-customer acquisition — a sign of rising churn, smaller average contract sizes, or expansion stalling.

Bad

The seat count is declining period-over-period; churned and downgraded seats are outpacing new bookings and upsells, eroding the base beneath revenue.

Watch-outs

  • Conflating contracted users with active users or MAU. This metric counts contractually licensed seats; MAU counts who actually shows up in your product logs. A contract with 100 licensed seats but only 60 monthly actives still adds 100 to the count. MAU reveals adoption; contracted seats reveal commercial commitment.
  • Forgetting it's a snapshot, not an average. It's the count on the last day of the period — the figure on day 28 can differ sharply from day 31 if a large customer onboards or churns mid-month.
  • Double-counting or under-counting users across contracts. If the same person holds seats under two separate customer contracts, that's two seats — one per contract — not one.
  • Ignoring base composition. A 10% gain looks strong, but if it's all $10/month Starter seats while Enterprise seats leak away, revenue may be shrinking. Always decompose by plan tier and cohort.

Worked example

Hypothetical

Contracted UsersApril=5,000+300+200100150=5,250\text{Contracted Users}_{\text{April}} = 5{,}000 + 300 + 200 - 100 - 150 = 5{,}250

Close March with 50 active contracts totaling 5,000 contracted seats — 45 Enterprise customers at 100 seats each (4,500) and 10 Pro customers at 50 seats each (500). In April you sign 3 new Enterprise customers (+300 seats), 5 existing customers expand (+200 seats), 2 customers churn (−150 seats), and 3 downgrade (−100 seats). Closing April seat count is 5,250 seats, a 5% MoM increase.

Variants & windows

The same metric re-expressed by a mechanical transform — a trailing window, a growth rate, a per-unit scaling, or a book/segment cut. Each is computed from Total Contracted Users above.

  • Closing Contracted Users Closing · Contracted book

Related