HubSpot Contracts: The Contracts Object and How to Use It

HubSpot Contracts: What the New Contracts Object Does and How to Use It

Posted June 17, 2026 in HubSpot, Technology by Kaitlynn Sirotkin

The Contracts object is the newest and most strategically important addition in HubSpot Revenue Hub. It launched on June 16, 2026, and it’s the feature that transforms Revenue Hub from a billing tool into a connected revenue operating system.

Before Contracts, HubSpot had quoting, billing, and payments, but they were loosely connected. A signed quote didn’t automatically create anything. Billing logic had to be set up manually. Renewals were tracked in spreadsheets or external tools. Every team, sales, CS, finance, RevOps, was working from a different version of what the customer had bought.

Contracts changes all of that. Here’s exactly what it is, what it does, and why it matters.

What Is the HubSpot Contracts Object?

The Contracts object is a native CRM record in HubSpot that represents the living agreement between your company and a customer. It is not a PDF. It is not a document. It is a structured data record, the same kind of object as a Contact, Company, or Deal — that lives alongside every customer relationship in your CRM.

When a buyer accepts a Revenue Hub quote, a Contract record is created automatically. That contract carries:

The products and pricing from the accepted quote
Effective dates and term end dates
Revenue metrics: ACV, ARR, MRR, and TCV calculated automatically
The billing schedule that drives invoicing
The change history, every amendment, expansion, or modification to the agreement
Links to associated contacts, companies, and deals

From that point forward, the Contract is the single source of truth for everything related to that customer’s commercial relationship. Not the original quote. Not the billing platform. Not a spreadsheet. The Contract.

Why “CRM Object, Not a PDF” Is the Key Distinction

Most companies manage contracts as documents. A PDF gets signed, filed somewhere, and referenced occasionally. The problem is that a PDF can’t power anything. It can’t generate an invoice. It can’t flag a renewal. It can’t tell Breeze which customers are up for renewal this quarter. It can’t tell CS what a customer is paying before they walk into a renewal conversation.

A HubSpot Contract record can do all of those things, because it’s structured data connected to the rest of your CRM, not a static file sitting in a folder.

This is what HubSpot means when they describe Contracts as what makes Revenue Hub different from Commerce Hub. Commerce Hub had billing and payments. Revenue Hub has a connected data object at the center that ties the entire revenue lifecycle together.

What the Contract Record Contains

Commercial terms. Products, quantities, unit prices, billing terms, and contract value. These are pulled directly from the accepted quote — no re-entry required.

Revenue metrics. Annual Contract Value (ACV), Annual Recurring Revenue (ARR), Monthly Recurring Revenue (MRR), and Total Contract Value (TCV) are calculated automatically from the contract’s line items. RevOps can report on committed revenue directly from HubSpot without exporting from a billing platform.

Billing schedule. The contract’s line items define the billing cadence, monthly, quarterly, annual, or mixed across different products. Invoices generate automatically from this schedule. No one manually creates invoices.

Effective and term dates. Contract start date, effective date, and end date are tracked on the record. Renewal information — renewal date, days to renewal, renewal status, is visible directly on the contract record without running a separate report.

Change history. Every amendment, expansion, downgrade, or modification to the contract is recorded in the contract’s history. Every team can see exactly what changed, when, and why.

Associations. The contract record links to the originating deal, the associated contacts and company, all generated invoices, and all payments. The full commercial picture of a customer relationship is accessible from a single record.

Breeze AI summary. The Breeze record summary on the contract gives a plain-language overview of the contract status, value, associated contacts, and recent activity, without anyone having to read through multiple fields.

The Two Post-Close Motions Contracts Powers

The Contract doesn’t just store what was sold, it’s the starting point for the two most important revenue motions that happen after close.

Change Quotes — Mid-Term Expansions

When a customer wants to add seats, upgrade their plan, or adjust quantities before the current term ends, you create a change quote directly from the contract record.

The change quote inherits all existing entitlements automatically. The rep adds only the delta — the new seats, the upgraded product, the adjusted quantity. Proration is calculated automatically based on the remaining term. The customer sees only what’s changing, not a full re-quote of everything they already own.

When the change quote is accepted, the contract updates in place. The billing schedule adjusts. A new invoice for the prorated amount generates automatically. No new deal creation. No manual billing adjustment. The contract record now reflects the current state of the relationship.

This matters because mid-term expansions are where a lot of revenue gets left on the table. When the process for adding seats requires recreating a quote from scratch, running it back through approvals, and manually updating billing, reps avoid it. When it’s a change quote generated in two clicks from the contract, it becomes frictionless.

Renewal Quotes — Next Term

When a contract approaches its end date, a renewal quote is generated directly from the contract record. It inherits all current products and entitlements. You apply uplift rules, adjust terms, change the product mix, or add new products before sending.

When the renewal is accepted, a new contract record is created and automatically linked to the original. This link maintains a single contiguous revenue history, every contract in the customer’s lifecycle is traceable back to the original agreement.

This matters because it means every renewal conversation starts from a complete picture. CS doesn’t need to check a billing platform, pull a spreadsheet, or ask RevOps what the customer is currently paying. The contract record has everything: what they’re paying, what’s in their current subscription, when the term ends, and the full history of every change since they first signed.

Who Benefits from Contracts and How

Customer Success

CS teams benefit most visibly from the Contracts object. Before renewals, they open the contract record and see the complete commercial picture, products, pricing, billing status, contract end date, and the full history of changes. No guesswork. No asking Finance. No outdated spreadsheet.

Breeze surfaces renewals at risk before CS walks in without context. The contract record powers that signal, Breeze reads the contract data and flags accounts that need attention before the renewal conversation.

RevOps

RevOps benefits from the reporting and data integrity the Contracts object creates. Committed ARR, MRR, and ACV are tracked in HubSpot rather than calculated from exports. The full contract history creates an audit trail for every commercial decision. Month-end close doesn’t require reconciling what was sold against what was billed, the contract is the source of truth for both.

Finance

Finance benefits from the automation the contract drives. Invoices generate from the billing schedule automatically. Credit memos connect to the originating invoice. Payment status flows back into the contract record in real time. Finance can see what’s been collected vs. what’s outstanding without asking RevOps for a report.

Sales

Sales benefits from the expansion motion the Contracts object enables. Change quotes generated from contract records make mid-term expansions fast enough that reps actually pursue them. The contract’s revenue metrics, ACV, ARR, are visible on the deal record, giving sales leaders a clean picture of bookings and committed revenue.

What Contracts Does Not Do

Contract redlining. The Contracts object manages the commercial terms, billing, and renewal motions. It does not support clause-level negotiation, legal markup, or version control on contract language. If your deals involve back-and-forth on legal terms, that still requires a separate tool like PandaDoc or a CLM system.

Complex contract templates. Contracts in Revenue Hub are data records, not formatted documents. The quote is the customer-facing document; the contract is the operational record. If you need a branded, multi-section contract document for signature, that lives in the quote layer, not the contracts layer.

eInvoicing compliance in certain EU countries. Billing and contracts are available to EU customers, but are not legally compliant for e-invoicing mandates in all EU jurisdictions. EU customers should evaluate this carefully before relying on automated invoicing for compliance purposes.

How to Set Up HubSpot Contracts

Contracts are configured as part of the Revenue Hub billing setup.

Here are the key configuration steps:

Proration defaults. Set how proration is calculated when a contract changes mid-term, whether it’s calculated by day, week, or billing cycle, and how credits for unused time are handled.

Renewal quote setup. Configure the renewal quote template and default behavior, whether renewal quotes are created manually or triggered automatically as the contract approaches its end date, and what uplift rules apply by default.

Automatic deal creation. Configure whether accepted renewal quotes automatically create a new deal in the pipeline. This keeps your sales pipeline current with renewal bookings without manual entry.

Change quote templates. Build change quote templates that inherit existing entitlements correctly and present only the delta to the buyer cleanly.

Contract record properties. Customize the contract record to capture any business-specific data your team needs, custom contract types, customer tier, product line, or territory.

For a full walkthrough of the implementation sequence that includes contracts setup: How to Set Up HubSpot Revenue Hub: A Step-by-Step Implementation Guide

Frequently Asked Questions

Is the HubSpot Contracts object available on all plans? Yes. The Contracts object is available to all Revenue Hub customers across all plans. CPQ features (quotes, approvals) require a Revenue Hub Professional or Enterprise seat, but contracts and billing features are available at no additional monthly cost currently.

Does every quote automatically create a contract? When a quote is accepted, a contract is created automatically. You can also configure manual contract creation for quotes that don’t follow the standard flow. Admins control this behavior in the contracts setup.

What happens to existing customers who were managed in a separate billing system? Existing customers can be migrated to HubSpot Contracts, but this requires a structured migration approach. Existing billing relationships need to be recreated as contract records, and the billing history should be documented in the record. This is typically part of a phased implementation — new business moves to Revenue Hub first, and existing customers are transitioned on renewal.

How does the contracts object interact with HubSpot’s standard deal pipeline? The contract is linked to the originating deal. When a renewal quote is accepted, you can configure Revenue Hub to automatically create a new renewal deal in your pipeline. This keeps your pipeline current with renewal bookings without requiring manual entry from sales or CS.

Can I report on contract metrics in HubSpot dashboards? Yes. ACV, ARR, MRR, TCV, contract end dates, and renewal status are all reportable properties on the contracts object. You can build dashboards that show committed revenue, upcoming renewals, and contract health without exporting from a billing platform.

What’s the difference between a subscription and a contract in Revenue Hub? A subscription is the recurring billing relationship, the automated billing schedule that runs invoices. A contract is the broader commercial record that governs the subscription, including the products, pricing, term, change history, and renewal motion. The contract powers the subscription; the subscription executes the billing.

How Fast Slow Motion Helps

Configuring the Contracts object correctly, particularly the change quote and renewal quote motions, proration logic, and the reporting layer, is one of the most impactful parts of a Revenue Hub implementation. Getting it right means your CS team always knows what customers are paying, your RevOps has clean committed revenue data, and your expansion and renewal motions run without friction.

If you’re implementing Revenue Hub and want to make sure contracts are set up to support your specific renewal and expansion workflows, we’re glad to help.

Talk to an FSM consultant about HubSpot Revenue Hub →

Related Resources

Tags:

CRM, HubSpot, Revenue Hub