View and manage contracts

Use contracts to track and manage agreements associated with quotes in HubSpot. Contracts are the centralized source of truth for committed revenue in HubSpot.

This article covers how to view and manage contracts, and their associated records. Learn how to review contract details, associated revenue, activities, and history, and how to make mid-contract changes using change or renewal quotes, terminate contracts, or export contracts.

To get started, learn more about how contracts are used, and how to create contracts.

Before you get started

Accepted quotes can create contracts whether or not you're enrolled in the Connected CPQ, Billing, and Payments beta. If you're not enrolled in the beta, payment collection remains tied to the existing quote or standalone invoice experience. With the beta, contracts are used to manage ongoing billing, invoice creation, and payment collection. Learn more about the Connected CPQ, Billing, and Payments beta process.

View contract records

View contracts on the index page

Use the contract index page to view all contracts and to create and use saved views to filter contracts by specific criteria. To view all contracts:

1. In your HubSpot account, navigate to Commerce > Contracts.
2. To edit the columns that appear in the table, click Edit columns in the upper right of the table.
3. To filter the index page, click the filter dropdown menus (e.g., Status) and set your filter criteria. Contracts can have the following statuses:
   • Scheduled: when a contract is created with a future effective date, the status is set to Scheduled. On the effective date, the status is set to Active.
   • Active: a contract that's currently in effect.
   • Completed: a contract that's reached its end date.
   • Terminated: a contract that has been terminated.
   • Draft: a contract that isn't finalized.
4. To set custom filters, click Advanced filters at the top of the table.
5. To save a view for future use, click the Save icon at the upper right of the table.
6. To preview the contract details, hover over the contract and click Preview. View the details in the right panel.
7. To view the contract record, click the contract name. 

Learn more about the contract layout.

View contracts on associated CRM records

To view a contract from one of its associated records (for example, a contact, company, or invoice):

1. Navigate to your records. For example:
   • In your HubSpot account, click More, then navigate to CRM > Contacts. If More doesn't appear in your account, navigate to CRM > Contacts directly.
   • In your HubSpot account, click More, then navigate to CRM > Companies. If More doesn't appear in your account, navigate to CRM > Companies directly.
   • In your HubSpot account, click More, then navigate to Commerce > Invoices. If More doesn't appear in your account, navigate to Commerce > Invoices directly.
   • In your HubSpot account, click More, then navigate to Commerce > Quotes. If More doesn't appear in your account, navigate to Commerce > Quotes directly.
2. Open the right sidebar by clicking the name of a record, or by clicking Preview. The behavior depends on the object index page you're on.
3. In the right sidebar, navigate to the Contracts card to view the contract status. If the Contracts card isn't appearing on your record by default, you can manually add the card.
4. To view additional details, hover over the contract and click the Preview icon, or click the contract name to navigate to the contract.
   
   
5. Review the contract details in the right panel.

View the contract overview, activities, and history

Use the contract record to understand the contract information, including performance, associated line items, billing schedule, renewal information, timeline of activities, and history.

1. In your HubSpot account, navigate to Commerce > Contracts.
2. In the middle column, click the Overview tab to view a snapshot of the contract performance, line items, billing schedule, and renewal information.
   • The Contract performance card displays the contract value, recurring revenue information, the contract end date, and the amount billed.
     
     
   • The Current and upcoming line items card lists each of the contract's line items and their properties (e.g., price, quantity, billing schedule, term, pricing model).
     
     
   • The Renewal information card displays the renewal status, based on any renewal quotes created for the contract.
     
     
3. Click the Activities tab to view a timeline of communications (e.g., emails and calls), team activity (meetings, notes, tasks), and updates to the contract, and associated invoices, deals, and tickets.
   
   
4. Click the History tab to view details of contract changes and renewals, including changes in recurring revenue and line item additions or removals.

Manage contracts

On a contract record, you can manage a contract’s details. Create change and renewal quotes, update payment methods, terminate contracts, and manage associations.

Create a change or renewal quote on a contract

Create a change quote to modify an active contract agreement and use a renewal quote as a customer nears the end of their current contract. Learn more about creating change and renewal quotes.

Update the payment method of a contract

Send the contact of the contract a link to update their payment method.

1. In your HubSpot account, navigate to Commerce > Contracts.
2. Click the name of the contract.
3. In the upper left, click Actions, then select Update payment method.
4. In the dialog box, click Send link.
5. The buyer will be sent a link which they can click to update their payment method.

Terminate a contract

Contracts can be terminated immediately or on a scheduled date. To terminate a contract:

1. In your HubSpot account, navigate to Commerce > Contracts.
2. Click the name of the contract.
3. In the upper right of the left sidebar, click Actions, then select Terminate.
   
   
4. In the dialog box, click the date picker and select a termination date. Select today’s date to terminate immediately, or a future date to schedule a termination.
5. Click Terminate contract if terminating immediately, or Schedule termination if you’ve selected a future date.
6. The contract record will be updated with the termination information.
   
   

Change or cancel the termination of a contract

If you have scheduled a termination of a contract, you can change or cancel the termination.

1. In your HubSpot account, navigate to Commerce > Contracts.
2. Hover over a contract and click Preview.
3. In the upper right of the left sidebar, click Actions and select an option:
   • Change termination date: change the contract termination date. In the dialog box, click the date picker and select a new termination date. Click Update date.
   • Cancel termination: cancel the contract termination. In the dialog box, click Cancel termination to confirm.

Associate records with contracts

Add associations to contracts from the contract index page. You can associate contracts with contacts, companies, deals, tickets, quotes, invoices, and other contracts.

1. In your HubSpot account, navigate to Commerce > Contracts.
2. Hover over a contract and click Preview.
3. In the right sidebar, click + Add on an association card (e.g., Contacts).
4. In the right panel:
   • Search for and select the checkboxes next to the records you want to associate. Click Save to associate them to the contract.
   • Click the Create new tab to create a new record to associate to the contract. Enter the details of the new record and click Create to associate it to the contract, or Create and add another to create another record.

Export contracts

1. In your HubSpot account, navigate to Commerce > Contracts.
2. Click Export in the top right of the table.
3. In the dialog box:
   • Enter an export name in the Export name text box.
   • Click the File format dropdown menu, and select a format.
   • Click the Language of column headers dropdown menu and select a language.
   • Click Customize to customize the export further.
     • Under Properties included in export select an option for which properties to include in the export.
     • Under Associations included in export, select the Include associated record name checkbox to include associated record names (e.g., the invoice name).
     • Under Associations included in export, select whether to include up to 1,000 associated records, or all associated records.
   • Click Export.

Learn more about exporting records.

Analyze contract and revenue performance

Analyze revenue performance using out-of-the-box reports, or build custom reports that match your various teams’ needs.

For example, you can create reports for:

• Recurring revenue: track ARR, MRR, and contract value in real time.
  • MRR waterfall by month: the monthly movement of recurring revenue, including opening MRR, new revenue, upgrades, downgrades, churn, renewals, and ending MRR. Revenue is reported when it becomes effective.
  • Net new MRR by month: the net change in monthly recurring revenue each month based on revenue that becomes effective during the selected period. Calculated from revenue events such as new business, upgrades, downgrades, churn, and renewals. Use this report to track overall recurring revenue growth.
  • Booked MRR by month: the monthly recurring revenue booked during the selected period. Revenue is reported when the contract is booked, even if it becomes effective at a later date.
  • Booked TCV by month: the total contract value associated with contract actions booked during the selected period, grouped by revenue type (for example, new business, upgrades, downgrades, churn, and renewals). This report reflects the value of the booked contract action, not the resulting contract value, and is reported when the action is booked.

• Accounts receivable and cash: track open receivables and collected payments to analyze days sales outstanding (DSO).
• Retention: analyze churn and net revenue retention using contract renewal data.
• Attribution: view which deal sources contribute to high-value, long-term contracts.

Learn more about the commerce analytics suite and building custom reports.

Next steps

• Learn more about the Connected CPQ, Billing, and Payment beta.
• Learn more about creating change and renewal quote templates.
• Learn more about creating change and renewal quotes.