Commerce Objects

The Essence

The Subscription represents an ongoing commercial relationship โ€” not a one-time transaction, but a continuous commitment that renews and persists. It's the container for recurring revenue: what the customer is subscribed to, at what terms, for how long, and at what status.

Subscriptions don't replace Orders; they generate them. Each billing cycle, the Subscription produces an Order (the transaction), which produces an Invoice (the bill), which collects a Payment (the cash). The Subscription is the engine that keeps this cycle running.

This makes Subscription the heart of recurring revenue businesses โ€” MRR, ARR, retention, expansion all flow through Subscription management.

"Subscriptions don't replace Orders; they generate them. Each billing cycle, the Subscription produces an Order, which produces an Invoice, which collects a Payment. The Subscription is the engine that keeps this cycle running."


The Recurring Revenue Cycle

Subscription The Engine
Order
Invoice
Payment
Repeat Next cycle

Each billing cycle, the Subscription automatically generates this flow โ€” creating predictable, recurring revenue.


Unified View Contribution


Sarah's Story

When Sarah's organization activated their Office Hours - Strategy Seat, a Subscription was created:

Subscription Record:
  • Product: Office Hours - Strategy Seat
  • Amount: $595/month
  • Billing Frequency: Monthly
  • Start Date: When activated
  • Next Billing Date: One month from start
  • Status: Active
  • Payment Method: Card on file

This Subscription represented the ongoing relationship, not a single transaction. Each month:

  1. Billing cycle completes โ†’ Order automatically created for that month
  2. Order generates Invoice โ†’ Invoice for $595 sent to billing contact
  3. Payment charges โ†’ Stored payment method charged
  4. Payment completes โ†’ Invoice marked paid, cycle resets

Sarah could see all of this in her portal: her active Subscriptions, next billing date, payment method on file, and complete billing history.

Six months later, when Sarah's engagement expanded, she upgraded from Strategy Seat to Partnership Seat. The Subscription updated โ€” new amount ($1,495/month), upgrade date logged, previous terms preserved in history, billing continuing on the same cycle.

When Sarah eventually asked about pausing during a slow quarter, the Subscription supported that too: Status moved to "Paused," pause dates set, auto-resume scheduled. The Subscription managed the relationship through its natural lifecycle โ€” activation, usage, upgrades, pauses, renewals, and eventually (though hopefully not) cancellation.


What It Holds

Subscription Identity

What is the customer subscribed to? Product/service reference, subscription name, unique identifier. This connects the recurring relationship to your offering catalog.

Financial Terms

Amount, currency, billing frequency (monthly, quarterly, annually). These terms govern how much is charged and how often.

Billing Configuration

Payment method, billing contact, billing address. Where does the recurring charge go? Who receives the Invoice?

Timeline

Start date, current period, next billing date, end date (if termed). Timeline properties drive billing automation and renewal workflows.

Status

Active, Paused, Cancelled, Past Due, Pending. Status determines whether billing continues and what workflows trigger.

Usage and Entitlements

What does this Subscription grant access to? Usage limits, feature entitlements, seat counts. This connects billing to value delivery.

What It Connects To

Primary Associations

To Company

The organization with this Subscription

To Contacts

Subscriber contact, billing contact

To Products

What offering this Subscription is for

To Orders

Transactions generated each billing cycle

To Invoices

Bills generated each billing cycle

To Payments

Charges against this Subscription

Contact-to-Subscription Labels

Subscriber
1

The contact who owns/uses this Subscription

Billing Contact
1

Who receives Invoices (may differ from subscriber)

Decision Maker
1

Who can upgrade, downgrade, or cancel

Why These Labels Matter

Subscription relationships often involve multiple contacts. The subscriber uses the service. The billing contact receives invoices. The decision maker controls upgrades and cancellations. Clear labels ensure the right person gets the right communication at the right time.


Common Patterns

The Billing Cycle Pattern

Each billing period generates commerce records: Subscription active โ†’ Billing cycle date reached โ†’ Order created for this period โ†’ Invoice generated from Order โ†’ Payment charged to stored method โ†’ If successful: Cycle resets, next billing date set. If failed: Dunning process initiated.

The Upgrade/Downgrade Pattern

Subscription changes mid-cycle: Customer requests upgrade โ†’ Prorate current period (credit remaining days) โ†’ Activate new tier immediately โ†’ Next Invoice reflects new amount โ†’ Subscription.amount updated โ†’ Subscription history preserved.

The Renewal Pattern

For termed subscriptions: Renewal date approaching (30/60/90 days) โ†’ Renewal opportunity created (or automated) โ†’ Customer success outreach โ†’ If renewed: New term begins, Subscription continues. If not renewed: Subscription ends at term.

The Pause Pattern

Temporary suspension: Customer requests pause โ†’ Subscription.status = "Paused" โ†’ Billing suspended โ†’ Access may continue or suspend (per policy) โ†’ Resume date set โ†’ Auto-resume on date (or manual resume).

The Cancellation Pattern

Ending the relationship: Customer requests cancellation โ†’ Effective date set (immediate or end of period) โ†’ Cancellation reason captured โ†’ Final Invoice if needed โ†’ Subscription.status = "Cancelled" โ†’ Offboarding workflow triggered.

Value-First vs. Industrial-Age

โœ— Traditional Thinking โœ“ Value-First Thinking
Subscription = Billing automation Subscription = Ongoing relationship container
Renewals are collection events Renewals are relationship moments
Cancellation = Failure Cancellation = Data for improvement
Subscription status hidden Subscription status transparent to customer
Pause means lost revenue Pause means preserved relationship
Upgrades require new sales process Upgrades are natural progression

Why This Shift Matters

When Subscriptions are just billing automation, you miss the relationship signal. A cancellation is a finance event, not a customer success learning opportunity. An upgrade is revenue, not relationship deepening. The Subscription becomes plumbing rather than intelligence.

When Subscriptions represent ongoing relationships, everything is visible. Customer success teams see health signals. Renewal becomes a relationship conversation, not a collection event. Pauses preserve relationships that would otherwise cancel. The Subscription tells a story, not just a balance.


In Practice

Implementation details and configuration

What You'll See in HubSpot

Subscriptions live in Commerce โ†’ Subscriptions. Each Subscription has:

  • Left sidebar: Subscription properties, status, amount, frequency
  • Middle column: Billing history, activity timeline
  • Right sidebar: Associations to Company, Contacts, Orders, Invoices

The Subscription index supports filtering by status, product, amount, and renewal date.

Key Properties

Key Properties

Native HubSpot Properties

Property Type Purpose
hs_subscription_name Native Text Subscription identifier
hs_subscription_status Native Enumeration Active, Paused, Cancelled, Past Due
hs_amount Native Currency Recurring charge amount
hs_billing_frequency Native Enumeration Monthly, Quarterly, Annually
hs_start_date Native Date When Subscription began
hs_end_date Native Date When Subscription ends (if termed)
hs_next_billing_date Native Date Next scheduled charge
hs_payment_method Native Text Stored payment method reference

Value-First Custom Properties

Property Type Purpose
vf_subscription_tier Enumeration Free, Base, Strategy, Partnership
vf_subscription_health Enumeration Thriving, Stable, At Risk, Critical
vf_usage_level Enumeration Light, Moderate, Heavy, Champion
vf_upgrade_potential Enumeration Low, Medium, High
vf_renewal_likelihood Enumeration Auto-Renew, Likely, Uncertain, At Risk
vf_cancellation_reason Enumeration (For cancelled) Budget, Fit, Competition, Pause, Other
vf_pause_reason Text (For paused) Why paused
vf_pause_end_date Date (For paused) When to resume

Subscription Status Lifecycle

1

Pending

Setup payment method, configure billing

Entry Criteria

Subscription created but not yet active

Exit Criteria

Payment method stored, ready to activate

Portal Experience

In the My Value Path Portal, Sarah sees her Subscriptions:

My Subscriptions

  • Each active Subscription with tier, amount, frequency
  • Next billing date
  • Payment method on file (last 4 digits)
  • Manage options (upgrade, downgrade, pause, cancel)

Billing Management

  • Update payment method
  • Change billing contact
  • Download receipts
  • View upcoming charges

"Sarah controls her Subscription. She can see what she's paying, when, and why. Self-service respects her autonomy while maintaining relationship visibility."


See It In Action

Experience in the Value Path Simulator

โ†’ Billing Cycle: Watch a Subscription generate its monthly Order, Invoice, and Payment. See the automation that makes recurring revenue effortless.
โ†’ Upgrade Flow: See Sarah upgrade from Strategy to Partnership. Watch proration and new terms apply automatically.
โ†’ Health Signals: See how usage patterns update subscription health, triggering proactive customer success.

Key Moment: Notice how the Subscription tells a relationship story โ€” not just billing events, but engagement patterns, health signals, and lifecycle progression.

Experience Subscription in the Value Path Simulator


Explore Further