Future Methods with Higher Limits (Pilot)

We provide this feature to selected customers through a pilot program that requires agreement to specific terms and conditions. To be nominated to participate in the program, contact Salesforce. Because pilot programs are subject to change, we can’t guarantee acceptance. This pilot feature isn’t generally available, as referenced in this document or in press releases or public statements. We can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available features.

Note

Apex future methods (methods that are annotated with @future) currently have the higher asynchronous limits for heap size, CPU timeout, and number of SOQL queries. This pilot enables you to specify even higher values for these limits and for additional limits in future methods. If you’re exceeding a governor limit in your future method, or if you think a future method requires a higher limit, you can increase this limit for your future method. This pilot also allows you to invoke a future method from another future method.

Running future methods with higher limits can slow down the execution of all your future methods.

Note

One of the following limits can be doubled or tripled for each future method.

Heap size
CPU timeout
Number of SOQL queries
Number of DML statements issued
Number of records that were processed as a result of DML operations, Approval.process, or Database.emptyRecycleBin

The higher limit is specified in the method definition as part of the @future annotation by using the limit parameter, in the following syntax:

1@future(limits='2x|3xlimitName')
2

For example, to double the amount of heap size that is allowed in your future method, define your method as follows:

1@future(limits='2xHeap')
2public static void myFutureMethod() {
3    // Your code here
4}

Keep in mind that you can specify only one higher limit per future method. Decide which of the modifiable limits you need the most for your method.

Tip

The following limit modifiers are supported. The string value passed to the limits parameter inside the annotation is case-insensitive.

Modifier	Description
`@future(limits='2xHeap')`	Heap size limit is doubled (24 MB).
`@future(limits='3xHeap')`	Heap size limit is tripled (36 MB).
`@future(limits='2xCPU')`	CPU timeout is doubled (120,000 milliseconds).
`@future(limits='3xCPU')`	CPU timeout is tripled (180,000 milliseconds).
`@future(limits='2xSOQL')`	Number of SOQL queries limit is doubled (400).
`@future(limits='3xSOQL')`	Number of SOQL queries limit is tripled (600).
`@future(limits='2xDML')`	Number of DML statements limit is doubled (300).
`@future(limits='3xDML')`	Number of DML statements limit is tripled (450).
`@future(limits='2xDMLRows')`¹	Number of records that were processed as a result of DML operations is doubled (20,000).
`@future(limits='3xDMLRows')`¹	Number of records that were processed as a result of DML operations is tripled (30,000).

¹ Includes Approval.process and Database.emptyRecycleBin operations.

Apex Developer Guide

Future Methods with Higher Limits (Pilot)