Loading

Understand Salesforce Org Throttling

Data pubblicazione: Jul 10, 2026
Descrizione

To manage capacity and availability, Salesforce sometimes applies a throttle to your org in Sandbox or Production instances. When a throttle is active, requests are placed in a queue and executed at a slower rate compared to the incoming request rate — typically 50% of the incoming rate. The impact on your org depends on your implementation and can include increased request times, latency, or timeout errors.


Salesforce has automation and recurring processes that increase horizontal and vertical scale. Throttles are applied when these processes are exhausted and guardrails are not sufficient. Customer success is a shared responsibility, and Salesforce regularly notifies customers about phases in the customer lifecycle journey.

Risoluzione

Common Reasons for an Org Throttle

Understanding why a throttle was applied helps you identify the right prevention strategy. The most common causes are:

  • Execution of an inefficient Salesforce Object Query Language (SOQL) query
  • Unapproved performance testing — performance testing is only permitted on Sandbox instances via the approved performance testing process
  • A sudden spike in inbound synchronous requests per second, including browser requests and SOAP or REST API calls
  • A high number of inbound asynchronous requests per second, such as Bulk API jobs, @future jobs, and Apex Queueable jobs
  • Rare Salesforce infrastructure issues that trigger automatic or manual throttles

How a Throttle Works

Salesforce is a multi-tenant cloud platform, and ensuring all customers' success, scale, and performance is a mutual responsibility. Salesforce's automatic throttle algorithm identifies the top resource consumers by org and feature, and attempts to be as precise and accurate as possible. The top resource-consuming customer is most often the cause of high resource utilization.


Salesforce is actively working to improve this process to minimize the impact on the customer experience of the throttled org. Salesforce also uses AI to predict resource overutilization and dynamically adjust throttle rates to maximize the customer experience.


For all customers, an outbound support case is created that contains the following details about the throttle:

  • When the throttle was applied
  • Features that were throttled (such as URL, aura, and services)
  • Throttle rate
  • Resource utilization such as Database CPU (DB CPU) and Database Connection Pool (DB Conn Pool) — Signature customers only
  • Request rate and number of requests — Signature customers only
  • Throttle causation analysis — Signature customers only
Preventing an Org Throttle 
  1. Improve the SOQL performance by making the query selective. 
    1. Follow the guidance in the Well-Architected framework or work with a Success Architect. See Performance Patterns and Anti-Patterns. 
    2. See the Knowledge Article Make SOQL query selective.
  2. To identify inefficiencies and bottlenecks, do performance and scale testing in Sandbox or PTPaaS. Get Sandbox instance performance testing approval. 
    1. See Performance Testing FAQ.
    2. See Salesforce Help: Scale Center.
  3. Investigate large numbers of inbound requests and use scaling features like waiting rooms.
    1. For Signature customers, if events like flash sales or open enrollment are causing large numbers of requests, consider working with the Customer Success Manager (CSM) to enroll in the Key Event Management process.
    2. If the requests are related to a Denial of Service, set up DOS mitigation.
  4. Make asynchronous requests or batch them when possible, such as Bulk API.
  5. Set up monitoring and alerting in Production and prepare incident response plans for when the org gets throttled. Consider Signature Success or Premier Support for enhanced support and features. See Proactive Alert Monitoring: Database CPU Consumption Time.
  6. If none of the above apply, contact customer support. Internal Salesforce infrastructure issues are posted to trust.salesforce.com. 
Numero articolo Knowledge

000384939

 
Caricamento
Salesforce Help | Article