Batch size for data deployments
The batch size setting controls how many records Gearset sends to Salesforce at a time during a data deployment. You can find this setting on the Data Management page — it's only available to team owners.
What is a batch?
When Gearset transfers data from one org to another, it doesn't send all records at once. Instead, it breaks them into groups called batches. The default batch size is 10,000 records.
How does batch size affect my deployment?
A larger batch size means fewer batches — and fewer batches means a faster deployment.
A smaller batch size means more batches, which takes longer, but can be more reliable in some situations.
When should I change the batch size?
If your deployment is timing out — particularly due to Apex triggers running when records are inserted or updated — try reducing the batch size. Smaller batches put less pressure on Salesforce at once, which can resolve timeout errors.
Here is what the batch size settings looks like on the Data management setting page:
