This version of the documentation is archived and no longer supported.



The batchSize() method specifies the number of documents to return in each batch of the response from the MongoDB instance. In most cases, modifying the batch size will not affect the user or the application since the mongo shell and most drivers return results as if MongoDB returned a single batch.

The batchSize() method takes the following parameter:

  • size – The number of documents to return per batch. Do not use a batch size of 1.


Specifying 1 or a negative number is analogous to using the limit() method.

Consider the following example of the batchSize() method in the mongo shell:


This operation will set the batch size for the results of a query (i.e. find()) to 10. The effects of this operation do not affect the output in the mongo shell, which always iterates over the first 20 documents.