Opportunity Line Item

An Opportunity Line Item in Salesforce (OpportunityLineItem in the API) is a standard child object that represents a single Product included on an Opportunity, capturing the Quantity, UnitPrice, ListPrice, Discount, and TotalPrice for that line. Each Opportunity Line Item links to a parent Opportunity through OpportunityId and to a Product through PricebookEntryId — meaning an Opportunity Line Item always sits on top of a specific Price Book Entry and inherits its currency, list price, and product reference. The sum of all Opportunity Line Items' TotalPrice values populates the Amount field on the parent Opportunity (when "Use Product-Based Pricing" is enabled), which then drives forecasts, pipeline reports, and territory roll-ups. Opportunity Line Items snapshot pricing at insert time — subsequent changes to the underlying Price Book Entry do not propagate, so historical pipeline values remain stable as price lists evolve.

The Opportunity Line Item depends on the Opportunity's selected Price Book — once an Opportunity has line items, its Pricebook2Id cannot be changed without removing them all first. This catches new admins who try to switch an Opportunity from Standard to a custom Price Book mid-deal. The workaround is to delete all Opportunity Line Items, change the Pricebook2Id, then re-add the lines from the new Price Book — or, in CPQ-enabled orgs, use the CPQ reprice action which automates this swap.

Discounts on Opportunity Line Items can be expressed two ways: as a percentage Discount value (e.g., 10%, which Salesforce uses to compute the discounted UnitPrice) or by directly setting the UnitPrice below the ListPrice. Reporting on discount depth typically uses the Discount field, but if a rep types a custom UnitPrice instead, that line shows Discount = 0 even though the customer is paying less. Many orgs add a formula field like (ListPrice - UnitPrice) / ListPrice to capture the effective discount regardless of how it was entered.

Schedules add another dimension to the Opportunity Line Item: with Quantity Schedules and Revenue Schedules enabled, a single line item can spread its TotalPrice across multiple periods (monthly, quarterly, etc.) for time-phased forecasting. Each period becomes an OpportunityLineItemSchedule child record. This is essential for subscription deals where a single Opportunity Line Item represents a 12-month or multi-year contract that should be recognized incrementally rather than all at once.