SALESFORCE DEVELOPER LIMITS AND

ALLOCATIONS QUICK REFERENCE

Summary About This Quick Reference

Find the most critical limits
for developing Lightning This quick reference provides common limits and allocations for Salesforce and doesn’t cover all limits
Platform applications. and allocations. It might contain limits or allocations that don’t apply to your Salesforce org. Stated limits
aren’t a promise that the specified resource is available at its limit in all circumstances. Load, performance,
and other system issues can prevent some limits from being reached.
This guide doesn’t include limits or allocations for:
• User interface elements in the Salesforce application
• Field lengths of Salesforce objects
• Desktop integration clients
• Your Salesforce contract
Information for specific feature limits, such as the number of total and active rules in your org, are also in
Salesforce Help; see the topics for using that feature. For allocations per edition, see Salesforce Features
and Edition Allocations. For information on limits when using Salesforce Functions, see Functions Limits.
Contractual limits might also apply, as per your Salesforce contract.

Apex Governor Limits

Read up on Apex limits details in Execution Governors and Limits
Because Apex runs in a multitenant environment, the Apex runtime engine strictly enforces limits so that
runaway Apex code or processes don’t monopolize shared resources.

Per-Transaction Apex Limits

These limits count for each Apex transaction. For Batch Apex, these limits are reset for each execution of
a batch of records in the execute method.
This table lists limits for synchronous Apex and asynchronous Apex (Batch Apex and future methods)
when they’re different. Otherwise, this table lists only one limit that applies to both synchronous and
asynchronous Apex.

Description Synchronous Asynchronous

Limit Limit
Total number of SOQL queries issued1 100 200

Total number of records retrieved by SOQL queries 50,000 50,000

Total number of records retrieved by 10,000 10,000

Database.getQueryLocator

Total number of SOSL queries issued 20 20

Last updated: February 24, 2022

Salesforce Developer Limits and Allocations Quick Reference Apex Governor Limits

Description Synchronous Asynchronous

Limit Limit
Total number of records retrieved by a single SOSL query 2,000 2,000

Total number of DML statements issued2 150 150

Total number of records processed as a result of DML statements, 10,000 10,000

Approval.process, or database.emptyRecycleBin

Total stack depth for any Apex invocation that recursively fires triggers 16 16
due to insert, update, or delete statements3

Total number of callouts (HTTP requests or web services calls) in a 100 100
transaction

Maximum cumulative timeout for all callouts (HTTP requests or Web 120 seconds 120 seconds
services calls) in a transaction

Maximum number of methods with the future annotation allowed 50 0 in batch and
per Apex invocation future
contexts; 1 in
queueable
context

Maximum number of Apex jobs added to the queue with 50 1

System.enqueueJob

Total number of sendEmail methods allowed 10 10

Total heap size4 6 MB 12 MB

Maximum CPU time on the Salesforce servers5 10,000 60,000

milliseconds milliseconds

Maximum execution time for each Apex transaction 10 minutes 10 minutes

Maximum number of push notification method calls allowed per Apex 10 10

transaction

Maximum number of push notifications that can be sent in each push 2,000 2,000
notification method call

Maximum number of EventBus.publish calls for platform events 150 150

configured to publish immediately

1
In a SOQL query with parent-child relationship subqueries, each parent-child relationship counts as an
extra query. These types of queries have a limit of three times the number for top-level queries. The limit
for subqueries corresponds to the value that Limits.getLimitAggregateQueries() returns.
The row counts from these relationship queries contribute to the row counts of the overall code execution.
This limit doesn’t apply to custom metadata types. In a single Apex transaction, custom metadata records
can have unlimited SOQL queries. In addition to static SOQL statements, calls to the following methods
count against the number of SOQL statements issued in a request.
• Database.countQuery

2
Salesforce Developer Limits and Allocations Quick Reference Apex Governor Limits

• Database.getQueryLocator
• Database.query
2
Calls to the following methods count against the number of DML statements issued in a request.
• Approval.process
• Database.convertLead
• Database.emptyRecycleBin
• Database.rollback
• Database.setSavePoint
• delete and Database.delete
• insert and Database.insert
• merge and Database.merge
• undelete and Database.undelete
• update and Database.update
• upsert and Database.upsert
• EventBus.publish for platform events configured to publish after commit
• System.runAs
3
Recursive Apex that doesn’t fire any triggers with insert, update, or delete statements, exists
in a single invocation, with a single stack. Conversely, recursive Apex that fires a trigger spawns the trigger
in a new Apex invocation. The new invocation is separate from the invocation of the code that caused it
to fire. Spawning a new invocation of Apex is a more expensive operation than a recursive call in a single
invocation. Therefore, there are tighter restrictions on the stack depth of these types of recursive calls.
4
Email services heap size is 36 MB.
5
CPU time is calculated for all executions on the Salesforce application servers occurring in one Apex
transaction. CPU time is calculated for the executing Apex code, and for any processes that are called from
this code, such as package code and workflows. CPU time is private for a transaction and is isolated from
other transactions. Operations that don't consume application server CPU time aren't counted toward
CPU time. For example, the portion of execution time spent in the database for DML, SOQL, and SOSL isn't
counted, nor is waiting time for Apex callouts. Application server CPU time spent in DML operations is
counted towards the Apex CPU limit, but isn’t expected to be significant.

Note:
• Limits apply individually to each testMethod.
• To determine the code execution limits for your code while it’s running, use the Limits methods.
For example, you can use the getDMLStatements method to determine the number of
DML statements that have already been called by your program. Or, you can use the
getLimitDMLStatements method to determine the total number of DML statements
available to your code.

Per-Transaction Certified Managed Package Limits

Certified managed packages—managed packages that have passed the security review for
AppExchange—get their own set of limits for most per-transaction limits. Salesforce ISV Partners develop

3
Salesforce Developer Limits and Allocations Quick Reference Apex Governor Limits

certified managed packages, which are installed in your org from AppExchange and have unique
namespaces.
There’s no limit on the number of certified namespaces that can be invoked in a single transaction.
However, the number of operations that can be performed in each namespace must not exceed the
per-transaction limits. There’s also a limit on the cumulative number of operations that can be made across
namespaces in a transaction. This cumulative limit is 11 times the per-namespace limit. For example, if
the per-namespace limit for SOQL queries is 100, a single transaction can perform up to 1,100 SOQL
queries. In this case, the cumulative limit is 11 times the per-namespace limit of 100. These queries can
be performed across an unlimited number of namespaces, as long as any one namespace doesn't have
more than 100 queries. The cumulative limit doesn’t affect limits that are shared across all namespaces,
such as the limit on maximum CPU time.

Note: These cross-namespace limits apply only to namespaces in certified managed packages.
Namespaces in packages that aren’t certified don’t have their own separate governor limits. The
resources they use continue to count against the same governor limits used by your org's custom
code.
This table lists the cumulative cross-namespace limits.

Description Cumulative
Cross-Namespace
Limit
Total number of SOQL queries issued 1,100

Total number of records retrieved by Database.getQueryLocator 110,000

Total number of SOSL queries issued 220

Total number of DML statements issued 1,650

Total number of callouts (HTTP requests or web services calls) in a transaction 1,100

Total number of sendEmail methods allowed 110

Lightning Platform Apex Limits

The limits in this table aren't specific to an Apex transaction; Lightning Platform enforces these limits.

Description Limit
The maximum number of asynchronous Apex method executions (batch 250,000 or the number
Apex, future methods, Queueable Apex, and scheduled Apex) per a 24-hour of user licenses in your
period1 org multiplied by 200,
whichever is greater

Number of synchronous concurrent transactions for long-running transactions 10

that last longer than 5 seconds for each org.2

Maximum number of Apex classes scheduled concurrently 100. In Developer Edition

orgs, the limit is 5.

4
Salesforce Developer Limits and Allocations Quick Reference Apex Governor Limits

Description Limit
Maximum number of batch Apex jobs in the Apex flex queue that are in 100
Holding status

Maximum number of batch Apex jobs queued or active concurrently3 5

Maximum number of batch Apex job start method concurrent executions4 1

Maximum number of batch jobs that can be submitted in a running test 5

Maximum number of test classes that can be queued per 24-hour period The greater of 500 or 10
(production orgs other than Developer Edition)5 multiplied by the
number of test classes in
the org

Maximum number of test classes that can be queued per 24-hour period The greater of 500 or 20
(sandbox and Developer Edition orgs)5 multiplied by the
number of test classes in
the org

Maximum number of query cursors open concurrently per user6 50

Maximum number of query cursors open concurrently per user for the Batch 15
Apex start method

Maximum number of query cursors open concurrently per user for the Batch 5
Apex execute and finish methods

1
For Batch Apex, method executions include executions of the start, execute, and finish
methods. This limit is for your entire org and is shared with all asynchronous Apex: Batch Apex, Queueable
Apex, scheduled Apex, and future methods. To check how many asynchronous Apex executions are
available, make a request to REST API limits resource. See List Organization Limits in the REST API
Developer Guide. The license types that count toward this limit include full Salesforce and Salesforce
Platform user licenses, App Subscription user licenses, Chatter Only users, Identity users, and Company
Communities users.
2
If more transactions are started while the 10 long-running transactions are still running, they’re denied.
HTTP callout processing time isn’t included when calculating this limit.
3
When batch jobs are submitted, they’re held in the flex queue before the system queues them for
processing.
4
Batch jobs that haven’t started yet remain in the queue until they’re started. If more than one job is
running, this limit doesn’t cause any batch job to fail.execute methods of batch Apex jobs still run in
parallel.
5
This limit applies to tests running asynchronously. This group of tests includes tests started through the
Salesforce user interface including the Developer Console or by inserting ApexTestQueueItem
objects using SOAP API.
6
For example, assume that 50 cursors are open. If a client application, logged in as the same user, attempts
to open a new one, the oldest of the 50 cursors is released. Cursor limits for different Lightning Platform
features are tracked separately. For example, you can have all these cursors open concurrently: 50 Apex

5
Salesforce Developer Limits and Allocations Quick Reference Apex Governor Limits

query cursors, 15 for the Batch Apex start method, 5 each for the Batch Apex execute and finish
methods, and 5 Visualforce cursors.

Static Apex Limits

Description Limit
Default timeout of callouts (HTTP requests or Web services calls) in a 10 seconds
transaction

Maximum size of callout request or response (HTTP request or Web services 6 MB for synchronous
call)1 Apex or 12 MB for
asynchronous Apex

Maximum SOQL query run time before Salesforce cancels the transaction 120 seconds

Maximum number of class and trigger code units in a deployment of Apex 7500

Apex trigger batch size2 200

For loop list batch size 200

Maximum number of records returned for a Batch Apex query in 50 million

Database.QueryLocator

1
The HTTP request and response sizes count towards the total heap size.
2
The Apex trigger batch size for platform events and Change Data Capture events is 2,000.

Size-Specific Apex Limits

Description Limit
Maximum number of characters for a class 1 million

Maximum number of characters for a trigger 1 million

Maximum amount of code used by all Apex code in an org1 6 MB

Method size limit 65,535 bytecode

(Large methods that exceed the allowed limit cause an exception to be thrown instructions in compiled
during the execution of your code.) form

1
This limit doesn’t apply to Apex code in first generation(1GP) or second generation(2GP) managed
packages. The code in those types of packages belongs to a namespace unique from the code in your
org. This limit also doesn’t apply to any code included in a class defined with the @isTest annotation.
2
Large methods that exceed the allowed limit cause an exception to be thrown during the execution of
your code.

6
Salesforce Developer Limits and Allocations Quick Reference API Request Limits and Allocations

Push Notification Limits

An org can send up to 20,000 iOS and 10,000 Android push notifications per hour (for example, 4:00 to
4:59 UTC).Only deliverable notifications count toward this limit. For example, a notification is sent to 1,000
employees in your company, but 100 employees haven’t installed the mobile app yet. Only the notifications
sent to the 900 employees who have installed the mobile app count toward this limit.
Each test push notification that is generated through the Test Push Notification page is limited to a single
recipient. Test push notifications count toward an org’s hourly push notification limit.
When an org's hourly push notification limit is met, any additional notifications are still created for in-app
display and retrieval via REST API.

API Request Limits and Allocations

To maintain optimum performance and ensure that the Lightning Platform API is available to all our
customers, Salesforce balances transaction loads by imposing three types of limits:
• Concurrent API Request Limits
• API Timeout Limits
• Total API Request Allocations
When a call exceeds a request limit, an error is returned.

Concurrent API Request Limits

The following table lists the limits for various types of orgs for concurrent inbound requests (calls) with a
duration of 20 seconds or longer.

Org Type Limit

Developer Edition and Trial orgs 5

Production orgs and Sandboxes 25

API Timeout Limits

The timeout limit for an API call is 600,000 milliseconds (10 minutes).
If a request exceeds this limit, the API returns a REQUEST_RUNNING_TOO_LONG status code (for
SOAP API) or a QUERY_TIMEOUT exception code (for REST API).
For calls to Composite Resources in REST API, this timeout applies to the entire composite request, not to
each subrequest.

Total API Request Allocations

The following table lists the limits for the total inbound API requests (calls) per 24-hour period for an org.

7
Salesforce Developer Limits and Allocations Quick Reference API Request Limits and Allocations

Salesforce Edition API Calls Per License Type Total Calls Per 24-Hour
Per 24-Hour Period Period
Developer Edition N/A 15,000

• Enterprise Edition • Salesforce: 1,000 100,000 + (number of licenses x

calls per license type) + purchased
• Professional Edition with • Salesforce Platform: 1,000
API Call Add-Ons
API access enabled • Lightning Platform - One App:
200
• Customer Community: 0
• Customer Community Login:
0
• Customer Community Plus:
200
• Customer Community Plus
Login: 10
• External Identity 25,000 SKU:
70,000
• External Identity 250,000 SKU,
750,000
• External Identity 1,000,000
SKU: 4,000,000
• Partner Community: 200
• Partner Community Login: 10
• Lightning Platform Starter: 200
per member for Enterprise
Edition orgs
• Lightning Platform Plus: 1000
per member for Enterprise
Edition orgs

• Unlimited Edition • Salesforce: 5,000 100,000 + (number of licenses x

calls per license type) + purchased
• Performance Edition • Salesforce Platform: 5,000
API Call Add-Ons
• Lightning Platform - One App:
200
• Customer Community: 0
• Customer Community Login:
0
• Customer Community Plus:
200
• Customer Community Plus
Login: 10
• External Identity 25,000 SKU:
70,000

8
Salesforce Developer Limits and Allocations Quick Reference API Request Limits and Allocations

Salesforce Edition API Calls Per License Type Total Calls Per 24-Hour
Per 24-Hour Period Period
• External Identity 250,000 SKU,
750,000
• External Identity 1,000,000
SKU: 4,000,000
• Partner Community: 200
• Partner Community Login: 10
• Lightning Platform Starter: 200
per member for Unlimited and
Performance Edition orgs
• Lightning Platform Plus: 5,000
per member for Unlimited and
Performance Edition orgs

Sandbox N/A 5,000,000

For Experience Cloud limits, see Experience Cloud User Licenses.

Note: Load, performance, and other system issues can prevent you from using your entire allocation
of calls in a 24–hour period.
APIs that count toward this allocation include the Lightning Platform REST API, the Lightning Platform
SOAP API, Bulk API, and Bulk API 2.0. API calls issued by certain Salesforce connected apps (for example,
the Salesforce mobile app) don’t count. To determine which APIs affect the allocation, see Monitoring
Your API Usage.
Calls that include DebuggingHeader have a separate allocation limit of 1,000 calls per 24-hour period.
These calls can continue to be made after the total request limit for an org is reached.
Limits and allocations are enforced against the aggregate of all API calls made to the org in a 24-hour
period. Limits and allocations are not on a per-user basis.

Monitoring Your API Usage

To better monitor your org’s API usage and limits, you can use these resources:
• The API Usage section of the System Overview page in Setup.
• The API Requests, Last 24 Hours item in the Organization Detail section of the System Overview page
in Setup.
• The API Request Limit per Month usage-based entitlement, which shows you your org’s API calls
aggregated over 30 days. This can be found on the Company Information page in Setup.
• Information returned in the Sforce-Limit-Info response header for REST APIs.
• Information returned in the response body (in <type>API REQUESTS</type>) for SOAP APIs.
• The /limits call in the Lightning Platform REST API.
You can configure your org so that email is sent to a designated user when the number of API requests
has exceeded a specified percentage of the amount allotted. Perform this configuration from Setup by

9
Salesforce Developer Limits and Allocations Quick Reference API Request Limits and Allocations

entering API Usage Notifications in the Quick Find box and then selecting API Usage
Notifications.
See also the Learn About Daily Rate Limits section in the App Development Without Limits Trailhead
module.

What Happens If You Reach or Exceed Your API Request

Limit
If your org reaches or exceeds its daily API request limit, Salesforce still allows the operations to proceed
by a certain amount, if possible. This helps avoid blocking your workflows during unexpected spikes in
workloads and occasional peak periods. A hard cap is in place to safeguard platform resources and prevent
API requests from exceeding the daily limit unimpeded.

Note: The ability to go over your normal daily limit is always subject to restrictions to protect the
overall health of the Salesforce instance that hosts your org. (You can monitor the health of your
instance on Salesforce Trust.)
This ability is designed to be used occasionally to help avoid interruptions in your workflow. Don’t
rely on it on an ongoing basis. To increase your allocation, contact your Salesforce account
representative.
This ability only applies to paid orgs in active status. It does not apply to trial orgs, Developer Edition,
or sandboxes.

API request activity is aggregated into 30 day periods, starting with your contract start date, and includes
calls that exceed the org's entitled limit.

Increasing Total API Request Allocations

The calculation of the API request amounts based on user licenses is designed to allow sufficient capacity
for your org based on your number of users. If you need a higher amount and you don’t want to purchase
extra user licenses or upgrade to Performance Edition, you can purchase extra API calls. For information,
contact your account representative.
Before you purchase more API calls, perform due diligence of your API usage. You can optimize a client
application, whether it’s your own enterprise application or partner application, to use fewer API calls and
still accomplish the same work. If you use a partner product, consult with the vendor to verify that the
product makes optimal use of the API. A product that makes inefficient use of the API incurs unnecessary
costs for your company. Use REST API composite resources to improve your application’s performance by
minimizing the number of round-trips between the client and server.

Example API Usage Metering Calculations

The following examples illustrate API usage metering calculations for several scenarios.
• For an Enterprise Edition org with 15 Salesforce licenses, the request limit is 115,000 requests (100,000
plus 15 licenses x 1,000 calls).
• For a Developer Edition org that made 14,500 calls at 5:00 AM Wednesday, 499 calls at 11:00 PM
Wednesday, only one more call can successfully be made until 5:00 AM Thursday.

10
Salesforce Developer Limits and Allocations Quick Reference Connect REST API Limits

Request Size Limits

In each REST call, the maximum length for the combined URI and headers is 16,384 bytes. A request
exceeding this limit returns a 431 Request Header Fields Too Large error. If the URI itself exceeds this limit,
the request returns a 414 URI Too Long error.

Note: Other factors, such as browsers and load balancers, can lower the maximum length of the
URI and headers. For public-facing services, it’s recommended to limit URI length to 2000 characters
and headers to approximately 8000 bytes.

Length of Stored Third-Party Refresh and Access Tokens

Salesforce stores third-party access and refresh tokens of up to 10,000 characters in length.

Connect REST API Limits

Limits protect shared resources. These are the limits for consumers of Connect REST API.
Connect REST API requests are subject to rate limiting. Connect REST API has a different rate limit than
other Salesforce APIs. Connect REST API has a per user, per application, per hour rate limit. When you
exceed the rate limit, all Connect REST API resources return a 503 Service Unavailable error code.
For applications using a session ID from Salesforce, the rate limit is per user, per hour—there isn't a separate
bucket for applications. All applications the user accesses with a session ID use this general quota. To take
advantage of the per user, per application, per hour limit, use OAuth tokens.

Note: Load, performance, and other system issues can prevent some limits from being reached.
Limits can change without notice. Applications should make efficient use of available requests and
gracefully handle the 503 error code.

Bulk API and Bulk API 2.0 Limits and Allocations

Batch Allocations
You can submit up to 15,000 batches per rolling 24-hour period. This allocation is shared between Bulk
API and Bulk API 2.0, so every batch that is processed in Bulk API or Bulk API 2.0 counts towards this
allocation.
In Bulk API 2.0, only ingest jobs consume batches. Query jobs do not. For details, see How Requests Are
Processed in the Bulk API 2.0 Developer Guide.
In Bulk API 2.0, batches are created for you automatically. In Bulk API, you must create the batches yourself.

Limits Specific to Ingest Jobs

Item Bulk API Limit Bulk API 2.0 Limit
Maximum number 150,000,000 (15,000 batches x 10,000 records 150,000,000
of records uploaded per batch maximum)

11
Salesforce Developer Limits and Allocations Quick Reference Bulk API and Bulk API 2.0 Limits and Allocations

Item Bulk API Limit Bulk API 2.0 Limit

per 24-hour rolling
period

Batch processing Batches are processed in chunks. The chunk Same as Bulk API
time size depends on the API version. In API version
20.0 and earlier, the chunk size is 100 records.
In API version 21.0 and later, the chunk size is
200 records. If it takes longer than 10 minutes
to process a whole batch, the Bulk API places
the remainder of the batch back in the queue
for later processing. If the Bulk API continues
to exceed the 10-minute limit on subsequent
attempts, the batch is placed back in the
queue and reprocessed up to 10 times before
the batch is permanently marked as failed.

Maximum time 10 minutes The API automatically handles

before a batch is retries. If you receive a message
retried that the API retried more than 10
times, use a smaller upload file
and try again.

Maximum file size 10 MB 150 MB

Maximum number 131072 Same as Bulk API

of characters in a
field

Maximum number 5,000 Same as Bulk API

of fields in a record

Maximum number 400,000 Same as Bulk API

of characters in a
record

Maximum number 10,000 N/A

of records in a batch

Maximum number 10,000,000 N/A

of characters for all
the data in a batch

Limits Specific to Query Jobs

Item Bulk API Limit Bulk API 2.0 Limit
Number of attempts to query 15 attempts at 10 minutes each The API automatically handles
to process the batch. There is also retries. If you receive a message
a 2-minute limit on the time to that the API retried more than 15

12
Salesforce Developer Limits and Allocations Quick Reference Bulk API and Bulk API 2.0 Limits and Allocations

Item Bulk API Limit Bulk API 2.0 Limit

process the query. If more than times, apply a filter criteria and try
15 attempts are made for the again.
query, an error message of “Tried
more than fifteen times” is
returned. If the query takes more
than 2 minutes to process, a
QUERY_TIMEOUT error is
returned.

Number of retrieved files 15 files. If the query returns more N/A

than 15 files, add filters to the
query to return less data. Bulk
batch sizes are not used for bulk
queries.

Results lifespan 7 days Same as Bulk API

Maximum retrieved file size 1 GB. If processing of the batch Same as Bulk API.
results in 1GB of retrieved data, Additionally, the API client can
then those results are saved to navigate through the full set of
disk, and then the batch is put results by using the locator
back on the queue to be resumed and maxRecords query
later. This also counts as one of parameters. The client is not
the 15 retries. bound to a set of files.

Number of query jobs that can be See Batch Allocations. 10,000

submitted per 24-hour rolling The current number can be seen
window in the
DailyBulkV2QueryJobs
value in the response to the
/vXX.X/limits/ REST API
method.

Total query results that can be N/A 1 TB.

generated per 24 hour rolling The current size can be seen in
window the
DailyBulkV2QueryFileStorageMB
value in the response to the
/vXX.X/limits/ REST API
method.

Number of characters in a SELECT N/A 32,000

clause.
This limit pertains to all the fields
listed between SELECT and FROM.
This includes the commas that
separate the fields and the

13
Salesforce Developer Limits and Allocations Quick Reference Bulk API and Bulk API 2.0 Limits and Allocations

Item Bulk API Limit Bulk API 2.0 Limit

quotation marks that Salesforce
automatically wraps around each
field. Salesforce automatically
removes any spaces between
fields.
For example, in this query
SELECT CloseDate,
Name,StageName,Amount
FROM Opportunity
Salesforce converts the SELECT
clause to
"CloseDate","Name",
"StageName","Amount"
The number of characters in this
example is 39.

General Limits
Item Bulk API Limit Bulk API 2.0 Limit
Batch and job Batches and jobs that are older than seven Jobs in a terminal state
lifespan days are removed from the queue if batches (completed, aborted, or failed)
are in a terminal state (completed, aborted, or that are older than seven days are
failed), regardless of their respective job status. deleted. Jobs in a non-terminal
The seven days are measured from the state that are older than seven
youngest batch associated with a job, or the days are periodically cleaned up.
age of the job if there are no batches. You can’t
create batches associated with a job that is
more than 24 hours old. Batches in a
non-terminal state that are older than seven
days are periodically cleaned up with their
respective jobs.

Binary content • The length of any file name can’t exceed N/A
512 bytes.
• A zip file can’t exceed 10 MB.
• The total size of the unzipped content
can’t exceed 20 MB.
• A maximum of 1,000 files can be
contained in a zip file. Directories don’t
count toward this total.

14
Salesforce Developer Limits and Allocations Quick Reference API Query Cursor Limits

Item Bulk API Limit Bulk API 2.0 Limit

Maximum time that 24 hours The same. (But this only applies
a job can remain to ingest jobs, not query jobs.)
open

API Query Cursor Limits

A user can have up to 10 query cursors open at a time. If 10 QueryLocator cursors are open when a
client application, logged in as the same user, attempts to open a new one, then the oldest of the 10
cursors is released. If the client application attempts to open the released query cursor, an error results.

Note: Cursor limits for different Lightning Platform features are tracked separately. For example,
you can have 10 SOAP API query cursors, 10 Metadata API cursors, and 50 Apex query cursors open
at the same time.

SOAP API Call Limits

API Name API Limit Limit Description
create() Maximum number Your client application can add up to 200 records in a
of records created single create()call. If a create request exceeds 200
records, then the entire operation fails.

describeSObjects() Maximum number The describeSObjects() call is limited to a

of objects returned maximum of 100 objects returned.

emptyRecycleBin() Maximum number Your org can have up to 5,000 records per license in the
of records in the Recycle Bin at any one time. For example, if your org has
Recycle Bin five user licenses, 25,000 records can be stored in the
Recycle Bin. If your org reaches its Recycle Bin limit,
Salesforce automatically removes the oldest records, as
long as they have been in the recycle bin for at least two
hours.

getDeleted() Limits for returned If a getDeleted() call returns more than 600,000
records records, the exception EXCEEDED_ID_LIMIT is returned.

login() Login request size The login request size is limited to 10 KB.
limit

merge() Merge request limits • Up to 200 merge requests can be made in a single
SOAP call.
• Up to three records can be merged in a single request,
including the master record. This limit is the same as
the limit enforced by the Salesforce user interface. To
merge more than 3 records, do a successive merge.
• External ID fields cannot be used with merge().

15
Salesforce Developer Limits and Allocations Quick Reference Metadata Limits

API Name API Limit Limit Description

• If you selected the option to retain the most recently
updated data privacy record for merging leads and
contacts, but the caller does not have CRUD
permission for the selected data privacy record, the
merge process selects the data privacy record already
associated with the master record.

update() Maximum number Your client application can change up to 200 records in a
of records updated single update() call. If an update request exceeds 200
records, the entire operation fails.

query() and Batch size limits The maximum batch size is 2,000 records, but this number
queryMore() is only a suggestion. To maximize performance, the
requested batch size isn’t necessarily the actual batch size.
Salesforce Web Service Connector (WSC) clients can set
the batch size by calling setQueryOptions() on
the connection object. C# client applications can change
the batch size in the QueryOptions portion of the
SOAP header before invoking the query() call.
If the SOQL statement selects two or more custom fields
of type long text, the batch size can’t be greater than 200
records. This limit prevents large SOAP messages from
being returned.

Metadata Limits
The following limits apply to the Salesforce Extensions for Visual Studio Code, the Ant Migration Tool, and
the Metadata API.

Limit Description
Retrieving and You can deploy or retrieve up to 10,000 files at once. AppExchange packages
deploying metadata use different limits: They can contain up to 35,000 files. The maximum size of
the deployed or retrieved .zip file is 39 MB. If the files are uncompressed in an
unzipped folder, the size limit is 400 MB. Note the following:
• If using the Ant Migration Tool to deploy an unzipped folder, all files in
the folder are compressed first. The maximum size of uncompressed
components in an unzipped folder is 400 MB or less depending on the
compression ratio. If the files have a high compression ratio, you can
migrate a total of approximately 400 MB because the compressed size
would be under 39 MB. However, if the components can't be compressed
much, like binary static resources, you can migrate less than 400 MB.
• Metadata API base-64 encodes components after they’re compressed.
The resulting .zip file can't exceed 50 MB, which is the limit for SOAP

16
Salesforce Developer Limits and Allocations Quick Reference SOQL and SOSL Limits for Search Queries

Limit Description
messages. Base-64 encoding increases the size of the payload, so your
compressed payload can't exceed approximately 39 MB before encoding.
• You can perform a retrieve() call for a big object only if its index is
defined. If a big object is created in Setup and doesn’t yet have an index
defined, you can’t retrieve it.

Change sets Inbound and outbound change sets can have up to 10,000 files of metadata.

SOQL and SOSL Limits for Search Queries

Feature Limit Limit Description
SOQL statements Maximum length of By default, 100,000 characters. For details on SOQL
SOQL statements statement limits, including information on queries that
involve external objects, see Understanding Relationship
Query Limitations.

Note: Long, complex SOQL statements, such as

statements that contain many formula fields, can
result in a QUERY_TOO_COMPLICATED error.
The error occurs because the statement is
expanded internally when processed by
Salesforce, even though the original SOQL
statement is under the 100,000 character limit.
To avoid this error, reduce the complexity of your
SOQL statement.
Page layouts in Lightning with more than 250
fields can also cause a
QUERY_TOO_COMPLICATED error. Lightning
uses auto-generated SOQL to retrieve fields for a
record page layout, so the error can occur even
if there isn’t any customer-written SOQL.
The character limit can also be reached by
including too many currency fields. Currency fields
require SOQL to use a format method, roughly
doubling the field API name length for each
currency field.

SOQL WHERE Strings in SOQL 4,000 characters for each string within a WHERE clause.
clause WHERE clauses

SOQL query results Maximum rows 2,000 results total (API version 28.0 and later), unless you
returned specify custom limits in the query. This limit includes
results from child objects. Previous API versions return
200 results.

17
Salesforce Developer Limits and Allocations Quick Reference SOQL and SOSL Limits for Search Queries

Feature Limit Limit Description

SOSL statements Maximum length of By default, 100,000 characters. This limit is tied to the
SOSL statements SOQL statement character limit defined for your org.

SOSL search query Maximum length of If the SearchQuery string is longer than 10,000
strings SearchQuery string characters, no result rows are returned. If
SearchQuery is longer than 4,000 characters, any
logical operators are removed. For example, the AND
operator in a statement with a SearchQuery that’s
4,001 characters will default to the OR operator, which
could return more results than expected.

SOSL query results Maximum rows 2,000 results total (API version 28.0 and later), unless you
returned specify custom limits in the query. This limit includes
results from child objects. Previous API versions return
200 results.

Relationship queries Relationship query • No more than 55 child-to-parent relationships can

limits be specified in a query. A custom object allows up
to 40 relationships, so you can reference all the
child-to-parent relationships for a custom object in
one query.
• No more than 20 parent-to-child relationships can
be specified in a query.
• In each specified relationship, no more than five
levels can be specified in a child-to-parent
relationship. For example,
Contact.Account.Owner.FirstName
(three levels).
• In each specified relationship, only one level of
parent-to-child relationship can be specified in a
query. For example, if the FROM clause specifies
Account, the SELECT clause can specify only the
Contact or other objects at that level. It could not
specify a child object of Contact.

FOR VIEW and FOR Maximum The RecentlyViewed object is updated every time the
REFERENCE RecentlyViewed records logged-in user views or references a record. It is also
allowed updated when records are retrieved using the FOR
VIEW or FOR REFERENCE clause in a SOQL query.
To ensure that the most recent data is available,
RecentlyViewed data is periodically truncated down to
200 records per object. RecentlyViewed data is retained
for 90 days, after which it is removed on a periodic basis.

OFFSET clause Maximum number of The maximum offset is 2,000 rows. Requesting an offset
rows skipped by greater than 2,000 results in a
OFFSET NUMBER_OUTSIDE_VALID_RANGE error.

18
Salesforce Developer Limits and Allocations Quick Reference Visualforce Limits

Visualforce Limits
Limit Value
Maximum response size for a Visualforce page Less than 15 MB

Maximum view state size in a Visualforce page 170KB

Maximum size of a Visualforce email template 1 MB

Maximum file size for a file uploaded using a Visualforce page 10 MB

Maximum size of HTML response before rendering, when Visualforce page Less than 15 MB
is rendered as PDF

Maximum PDF file size for a Visualforce page rendered as a PDF 60 MB

Maximum total size of all images included in a Visualforce page rendered 30 MB

as a PDF

Maximum header size of a Visualforce page 8,192 bytes

Maximum request size of a JavaScript remoting call 4 MB

Maximum response size of a JavaScript remoting call 15 MB

Default timeout for a JavaScript remoting call 30,000 milliseconds (30

seconds)

Maximum timeout for a JavaScript remoting call 120,000 milliseconds (120

seconds)

Maximum rows retrieved by queries for a single Visualforce page request 50,000

Maximum rows retrieved by queries for a single Visualforce page request 1,000,000
in read-only mode

Maximum collection items that can be iterated in an iteration component 1,000

such as <apex:pageBlockTable> and <apex:repeat>

Maximum collection items that can be iterated in an iteration component 10,000

such as <apex:pageBlockTable> and <apex:repeat> in
read-only mode

Maximum field sets that can be displayed on a single Visualforce page. 50

Maximum field sets allowed per sObject. 2,000

Maximum fields through lookup relationships allowed per field set. 25

Maximum records that can be handled by StandardSetController 10,000

19