Salesforce Dictionary - Free Salesforce GlossarySalesforce Dictionary
Full Contract Line Item entry
How-to guide

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.

By Dipojjal Chakrabarti · Founder & Editor, Salesforce DictionaryLast updated May 20, 2026

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.

  1. 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.

  2. 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).

  3. 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.

  4. 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.

  5. 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.

  6. 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.

Gotchas
  • 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.

See the full Contract Line Item entry

Contract Line Item includes the definition, worked example, deep dive, related terms, and a quiz.