Foundational Entities
Subscription (Contract, Agreement)
Subscription (Contract, Agreement): A billable agreement between a customer and your product, with defined terms, pricing and status. The "what and when" of the relationship.
In the data model
Subscription is an entity in the GASP relationship graph.
Datasets
revenue_event(event)contract_event(event)amendment_event(event)subscription(snapshot)revenue_schedule(fact)
Fields on these datasets (36)
-
acvdecimal, contract_event -
amendment_typeenum, amendment_event -
auto_renewedboolean, subscription -
billed_amountdecimal, revenue_schedule -
change_natureenum, revenue_event, amendment_event -
contract_enddate, contract_event, subscription -
contract_event_typeenum, contract_event -
contract_startdate, contract_event, subscription -
currencystring, revenue_event, contract_event -
customer_idstring, revenue_event, contract_event, amendment_event, subscription, revenue_schedule -
event_datedate, revenue_event, contract_event, amendment_event -
event_idstring, revenue_event, contract_event, amendment_event -
event_typeenum, revenue_event -
expansion_classificationenum, revenue_event, amendment_event -
forecast_renewal_amountdecimal, subscription -
lifecycle_attributionenum, revenue_event, amendment_event -
mrrdecimal, subscription -
mrr_changedecimal, revenue_event, amendment_event -
mrr_enddecimal, subscription -
mrr_startdecimal, subscription -
new_mrrdecimal, revenue_event -
period_startdate, revenue_schedule -
plan_idstring, subscription -
prior_mrrdecimal, revenue_event -
recognition_correctboolean, revenue_schedule -
recognized_revenuedecimal, revenue_schedule -
renewal_amountdecimal, subscription -
renewal_complete_datedate, subscription -
renewal_notified_on_timeboolean, subscription -
renewal_trigger_datedate, subscription -
renewedboolean, subscription -
segmentstring, revenue_event, contract_event, amendment_event, subscription -
snapshot_datedate, subscription -
subscription_idstring, revenue_event, contract_event, amendment_event, subscription, revenue_schedule -
subscription_statusenum, subscription -
tcvdecimal, contract_event
Relationships
- Customer owns Subscription (1:N). A customer holds one or more subscriptions. Hierarchy Principle 1: customers own subscriptions, not the reverse.
- Subscription grants License (1:N). A subscription grants one or more licenses (seats, entitlements, feature access). Hierarchy Principle 3: licenses are derived from subscriptions.
- Subscription generates Revenue (GAAP) (N:1). Subscriptions generate recognized revenue over their term as obligations are fulfilled.
- Subscription generates Invoice (1:N). Subscriptions generate periodic invoices according to their billing schedule.
- Subscription incurs COGS (N:1). Delivering on subscriptions incurs costs (hosting, support, onboarding) that form the COGS basis for Gross Margin.
- Subscription priced by Plan (N:1). A subscription is priced according to a plan. Many subscriptions can share the same plan. Enables tier-mix analysis, upgrade-path metrics and packaging health.
Related Terms
Other definitions in Foundational Entities:
Customer (Account, Organization)
A distinct billing entity with one or more subscriptions. The "who" of your business relationship.
License (Entitlement, Access, Quota)
A specific capability, quantity or configuration granted by a subscription. The "how much" of the relationship.
Hierarchy Principles
1. **Customers own subscriptions, not the reverse.** A customer churns when *all* their subscriptions end.