Salesforce Dictionary - Free Salesforce GlossarySalesforce Dictionary
Full Quota entry
How-to guide

Loading and managing Quotas in Salesforce

Loading quotas is straightforward once the Forecasting feature is enabled and Forecast Types are configured. The choices are Data Loader for bulk loads, the Collaborative Forecasts UI for small teams, or an API integration for ongoing automation.

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

Loading quotas is straightforward once the Forecasting feature is enabled and Forecast Types are configured. The choices are Data Loader for bulk loads, the Collaborative Forecasts UI for small teams, or an API integration for ongoing automation.

  1. Enable Collaborative Forecasts and Forecast Types

    Setup, Forecast Settings, Enable. Pick the active Forecast Types (Revenue, Quantity, Splits, Product Family, Custom). Quotas attach to specific Forecast Types, so this decision precedes quota loading.

  2. Confirm the forecast hierarchy

    Setup, Forecasts Hierarchy. Confirm the manager/report relationships. Quotas roll up the hierarchy, so the hierarchy must be accurate before the load. A missing manager-rep link causes the rep's quota to not appear in the manager's view.

  3. Prepare the quota CSV

    Build a CSV with columns: UserId, StartDate (first day of the forecast period), QuotaAmount, QuotaQuantity, ForecastingTypeId, CurrencyIsoCode. Validate every UserId resolves to an active user.

  4. Upload through Data Loader

    Open Data Loader, Insert or Upsert against ForecastingQuota. Map the CSV columns to the object fields. Run the load. Confirm the result file shows success for every row.

  5. Verify in Collaborative Forecasts

    Open the Forecast tab as a user with quotas loaded. Confirm the quota appears for the right period and Forecast Type. Cross-check the manager view shows the rollup correctly.

  6. Build an integration for ongoing loads

    For monthly or quarterly refresh, build a scheduled job (MuleSoft, ETL, Salesforce CLI scripted) that upserts the latest quota plan. Avoid manual CSV loads at scale; they become an operational burden.

Key options
ForecastingQuota objectremember

The sObject that stores quota records. One record per user per period per Forecast Type.

Forecast Typeremember

Revenue, Quantity, Opportunity Splits, Product Family, Custom Number, Custom Currency. Each can have its own quotas.

Forecasts Hierarchyremember

The manager-rep tree that determines how quotas roll up. Must be accurate before quotas are loaded.

Quota Adjustmentremember

Manager-initiated change to a direct report's quota mid-period, tracked with attribution and audit trail.

Data Loader upsertremember

The standard bulk-load mechanism for quotas, using User + StartDate + ForecastingType as the external ID.

Gotchas
  • Quotas attach to a specific Forecast Type. Loading Revenue quotas without enabling the Revenue Forecast Type creates orphaned records that never appear in the UI.
  • The forecast hierarchy must be accurate before quota load. A missing manager-rep link breaks rollup silently, and managers see incomplete attainment views.
  • Quotas are time-bound. A quota with the wrong Start Date (off by one day at the period boundary) lands in the wrong forecast period. Validate dates against the org's Fiscal Year settings.
  • Manual UI quota entry is fine for 5 to 20 reps. Above that, Data Loader or an integration is the only practical path. Plan the load mechanism before agreeing to a quota-driven sales plan.
  • Manager-initiated quota adjustments distort historical attainment metrics. Most companies discourage mid-period adjustments. The audit trail exists; the policy is what controls usage.

See the full Quota entry

Quota includes the definition, worked example, deep dive, related terms, and a quiz.