Salesforce Dictionary - Free Salesforce GlossarySalesforce Dictionary
DictionaryAAnnuity
SalesBeginner

Annuity

An Annuity in Salesforce is a recurring-revenue product line that pays out the same amount on a regular cadence (monthly, quarterly, annually) for the life of the contract, rather than as a single up-front sale.

§ 01

Definition

An Annuity in Salesforce is a recurring-revenue product line that pays out the same amount on a regular cadence (monthly, quarterly, annually) for the life of the contract, rather than as a single up-front sale. In CRM terms, an Annuity Opportunity Product spreads its revenue over time through Revenue Schedules, with each scheduled installment landing in a specific period for forecasting. In the insurance industry sense (Financial Services Cloud Insurance), an Annuity is a contract between a customer and an insurance carrier that pays the customer a stream of income for a defined period or for life. Salesforce uses the same word in both contexts because the underlying revenue mechanics are similar: a base contract value plus a schedule of payments.

Two distinct Salesforce surfaces handle Annuities. Opportunity Products in Sales Cloud support Quantity and Revenue Schedules for any product flagged as scheduled, and Annuity products are the canonical example. Financial Services Cloud (Insurance) and Salesforce Industries (Insurance) ship dedicated objects for annuity contracts, riders, beneficiaries, and payment history, with policy-management UI for advisors and claims teams. Most orgs use only one of the two surfaces depending on whether they sell annuities (FSC) or model recurring product revenue inside a broader CRM (Opportunity Products with Schedules).

§ 02

How Annuities flow through Sales Cloud and Financial Services Cloud

Annuity products in Sales Cloud and Revenue Schedules

Mark a Product2 record with Can Use Revenue Schedule and Can Use Quantity Schedule on the Product page. On any Opportunity Product that references it, the user picks a Schedule Type (Default, Repeat, Divide), a Number of Installments, and an Installment Period. Salesforce generates an OpportunityLineItemSchedule row per installment. The forecast then shows each installment in the period it falls into, rather than the whole amount up front.

Schedule Types: Default, Repeat, Divide

Default places the full amount in one period. Repeat copies the full Quantity or Amount into every installment period (typical for true Annuities: 100k a year for five years). Divide splits the value equally across the installments (typical for amortized contracts: a 100k contract paid as 20k a year). The Type drives whether the schedule sums to the same total as the parent line or multiplies it.

Forecasting Annuity revenue

Collaborative Forecasts with a Revenue Forecast Type respects Revenue Schedules. Each installment counts in its own forecast period. A five-year annuity with annual installments shows in five future forecast periods rather than as a single line at deal close. The forecast rolls up naturally, and the Annuity stays visible through the life of the contract instead of disappearing after the Opportunity closes.

Annuities and renewals

Many Sales Cloud orgs use Annuities to model recurring software or service revenue. The renewal pattern is a new Opportunity each renewal cycle, with the schedule re-projecting future payments. Salesforce CPQ (now Revenue Cloud) automates this through Subscription Products and Contract objects, which are the modern equivalent of the legacy Annuity-via-Product-Schedule pattern.

Insurance Annuity contracts in Financial Services Cloud

Financial Services Cloud Insurance ships objects like Insurance Policy, Annuity, Annuity Rider, Annuity Beneficiary, and Payment History. An Annuity record stores Contract Number, Issue Date, Maturity Date, Premium Amount, Payout Frequency, and links to the policyholder Person Account. Advisors use FSC's Insurance Policy 360 view to manage the contract through its lifecycle and to plan client reviews.

Annuity riders and beneficiaries

Rider records (Guaranteed Minimum Income Benefit, Long-Term Care, Death Benefit) attach to the parent Annuity in FSC. Beneficiaries (primary, contingent, tertiary) attach the same way. These child records drive servicing reminders and compliance reporting. The model handles the regulatory complexity that comes with annuity contracts in regulated jurisdictions.

Reporting on Annuities

Sales Cloud annuities report through OpportunityLineItem and OpportunityLineItemSchedule. Custom report types that join Opportunity to its schedule rows expose installment-level pipeline. FSC annuities use the Insurance Policy report types. The two report-type families do not mix; an org running both surfaces typically needs parallel dashboards for each.

Common modelling decisions

Choosing between Sales Cloud Schedules and Salesforce CPQ for recurring revenue is the most common Annuity modelling decision. Schedules are free and lightweight but lack pricing logic, term changes, and renewal automation. CPQ adds those features and is the right answer for any org renewing more than a handful of customers per quarter. For insurance specifically, FSC Annuity objects beat both alternatives because they speak the regulated industry vocabulary natively.

§ 03

How to set up an Annuity product with Revenue Schedules

Enabling Schedules on a Product and using it on Opportunity Products takes about ten minutes. The judgement call is which Schedule Type matches the commercial reality of the contract.

  1. Enable Product Schedules

    Setup, Product Schedule Settings. Enable Revenue Schedules and (if needed) Quantity Schedules. The settings unlock the Schedule checkboxes on Product2.

  2. Flag the Annuity Product

    On the Product2 record, check Can Use Revenue Schedule. Optionally set the default Revenue Schedule Type and Installment Period on the Product itself so Opportunity users do not have to choose every time.

  3. Add the product to an Opportunity

    Open the Opportunity, add the Annuity Product as an Opportunity Product, then click Establish Revenue Schedule on the related list.

  4. Choose Schedule Type and installments

    Pick Default, Repeat, or Divide. Enter Number of Installments and Installment Period. Save. Salesforce generates one OpportunityLineItemSchedule row per installment.

  5. Validate the forecast

    Open the Forecasts tab and confirm each installment lands in the correct future period. If the period assignment is off, the installment date math is the usual cause.

Gotchas
  • Repeat schedules multiply the parent line total. A 100k annual annuity with Repeat over five installments rolls up to 500k. Confirm Type matches commercial intent.
  • Schedules respect the Opportunity Close Date for forecast period calculation, not the line item Start Date. Misaligned dates push installments into the wrong period.
  • Schedules are basic. They lack term changes, pro-ration, and renewal logic; for those, Salesforce CPQ is the right tool.
  • FSC Annuity objects are separate from Opportunity Schedules. Reporting and automation built on one surface do not cover the other.
§

Trust & references

Sources

Cross-checked against the following references.

Official documentation

Straight from the source - Salesforce's reference material on Annuity.

Was this entry helpful?
Help us write better definitions. Quick reactions or detailed edit suggestions.

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. How does Annuity forecasting calculate revenue?

Q2. Which field determines whether an Opportunity is treated as an annuity deal?

Q3. What kind of business benefits most from Annuity forecasting?

§

Discussion

Loading…

Loading discussion…