Contract Line Item
A Contract Line Item in Salesforce is a child record of a Contract that names a specific product or service covered by that contract, with quantity, unit price, term, and (depending on the implementation) entitlement and billing details.
Definition
A Contract Line Item in Salesforce is a child record of a Contract that names a specific product or service covered by that contract, with quantity, unit price, term, and (depending on the implementation) entitlement and billing details. Each Contract Line Item points back to a parent Contract through the Contract field and forward to a Product through the Product2Id field, similar to how an Opportunity Product joins an Opportunity to a Product on the sales side.
Contract Line Items exist because most real contracts cover more than one product. A SaaS contract might include the platform license, two add-on modules, and a support tier. Each of those is a separate Contract Line Item under the same Contract. The line items hold the pricing, quantity, and renewal terms specific to each product, while the parent Contract holds the overall term length, customer signature, and account-level metadata. Service Cloud uses Contract Line Items to drive entitlement (which products under this contract are eligible for support), and Revenue Cloud uses them to drive subscription billing.
How Contract Line Items work in Service Cloud and Revenue Cloud
The data model and key fields
The Contract Line Item object has a Contract lookup (parent), a Product2 lookup (the product), Quantity, Unit Price, Start Date, End Date, Status, and several relationship fields. The standard object has limited fields out of the box; most production deployments add custom fields for billing frequency, discount, renewal terms, and entitlement type. Revenue Cloud adds even more fields through its managed package.
Contract Line Items and Entitlements
In Service Cloud, each Contract Line Item is the parent for one or more Entitlement records. The Entitlement specifies which type of support the customer receives for that product (Standard, Premium, 24/7), the SLA terms, and the period during which the entitlement is active. When a customer logs a Case, the Case is matched to an Entitlement, which is matched to a Contract Line Item, which is matched to a Contract. The chain determines which SLA timer applies.
Contract Line Items and subscription billing
In Revenue Cloud and Subscription Management, Contract Line Items drive recurring billing. Each line item has a billing frequency (monthly, quarterly, annual), a unit price, and a quantity. The billing engine reads the line items and generates invoices accordingly. Modifications to the line items mid-term (add seats, change tier) flow into the next billing cycle. Renewal at end of term creates new Contract Line Items under a new Contract or extends the existing ones depending on configuration.
Relationship to Opportunity Products
At the closed-won moment of a sales cycle, Opportunity Products typically convert to Contract Line Items: same Product, same Quantity, same Unit Price, now under a Contract instead of an Opportunity. The conversion may be automatic (Sales Cloud with CPQ does this) or manual (custom Apex). Either way, the data lineage should preserve which Opportunity Product became which Contract Line Item for renewal forecasting and revenue attribution.
Modifications mid-contract
A common operation is changing the quantity or pricing of a Contract Line Item mid-term. Adding seats to a license, upgrading from Standard to Premium support, changing the billing frequency. Different orgs handle this differently. Some create a new Contract Line Item with a different Start Date; others amend the existing line item and write an audit trail. Revenue Cloud has a structured Amendment object for this; older orgs build it custom.
Reporting and revenue forecasting
Contract Line Item reports are the foundation of ARR (Annual Recurring Revenue) and MRR (Monthly Recurring Revenue) calculations. Reports typically sum Unit Price multiplied by Quantity multiplied by Term, grouped by Product, Account, or Stage (Active, Cancelled, Pending Renewal). Revenue Cloud ships pre-built reports for these patterns; older orgs build them on the standard object.
Custom Contract Line Item objects
Some long-running Salesforce orgs built their own Contract Line Item object before the standard ContractLineItem (introduced in Spring 14 for Service Cloud, extended in Revenue Cloud) was widely capable. These custom objects often have richer field models but lock the org out of Revenue Cloud and Subscription Management without significant migration work. New deployments should use the standard object plus Revenue Cloud extensions.
How to use Contract Line Items in Salesforce
The line items connect the Contract record to the products and services it covers. Most of the work is configuring the supporting objects (Products, Pricebooks, Entitlements, Subscription Plans) and letting the standard wiring do its job.
- Enable the Contract Line Item object
For Service Cloud orgs, Setup, Object Manager, ensure Contract Line Item is enabled. For Revenue Cloud, the line item ships as part of the package.
- Configure the Product2 records
Each Contract Line Item points to a Product2. Build the product catalog with the right Family, Active flag, and any custom fields the line item references (billing frequency, default term).
- Configure the Price Book
Contract Line Items pull pricing from a Price Book Entry. Configure the Standard Price Book and any custom price books needed for the contract scenarios.
- Build or configure the line-item creation logic
Decide how Contract Line Items get created. CPQ creates them automatically at close-won. Revenue Cloud creates them at checkout. Manual orgs use a Flow on Contract that copies Opportunity Products at activation.
- Set up Entitlement linkage
For Service Cloud entitlement management, link each Contract Line Item to one or more Entitlements. The Entitlement drives which Case matches which line item.
- Build reporting on Contract Line Items
Create custom report types that join Contract, Contract Line Item, Product, and Entitlement. The reports drive ARR, entitlement coverage, and renewal forecasting.
- The standard Contract Line Item object is Service Cloud-flavored. Revenue Cloud adds many more fields through its managed package; do not assume the standard object has everything.
- Quantity and Unit Price changes mid-contract have different semantics in different implementations. Amendments in Revenue Cloud, custom Apex in older orgs.
- Renewing a contract typically creates new Contract Line Items rather than extending old ones. Reports that group by line item should account for the cohort change at renewal.
- Contract Line Items are not directly searchable in global Salesforce search. To surface them, build a custom list view on the Contract page.
- Deleting a Contract Line Item is sometimes blocked by Entitlement or Order Product references. Soft-delete (Status = Cancelled) is safer than hard delete.
Trust & references
Cross-checked against the following references.
- ContractLineItem Object ReferenceSalesforce Developers
- Entitlement Management OverviewSalesforce Help
Straight from the source - Salesforce's reference material on Contract Line Item.
- Subscription Management OverviewSalesforce Help
- Revenue Cloud OverviewSalesforce Help
About the Author
Dipojjal Chakrabarti is a B2C Solution Architect with 29 Salesforce certifications and over 13 years in the Salesforce ecosystem. He runs salesforcedictionary.com to help admins, developers, architects, and cert/interview candidates sharpen their fundamentals. More about Dipojjal.
Test your knowledge
Q1. What does a Contract Line Item represent?
Q2. Which Salesforce product commonly uses Contract Line Items?
Q3. Why use line-level dates on Contract Line Items?
Discussion
Loading discussion…