multipart_chunksize - AWS SDKs and Tools


This setting applies only to AWS CLI commands in the s3 namespace.

Specifies the chunk size that the AWS CLI uses for Amazon S3 multipart transfers of individual files.


When the AWS CLI performs an Amazon S3 file transfer where the overall file size exceeds the multipart_threshold size, the AWS CLI divides the file into chunks of this setting's size. This value can be specified either as the number of bytes as an integer, or by using a size and a suffix.

Default value: 8MB

Valid values: The value is expressed as the number of bytes in the chunk. The value can be specified as:

  • An integer. For example, 1048576 sets the chunk size to 1 megabyte.

  • An integer followed by a size suffix. You can specify rate suffixes using the following: KB, MB, GB, or TB. For example, 300KB or 10MB.

Ways to set this value

Location Supported Example
config file Yes
s3 = multipart_chunksize = 5MB
credentials file -
Environment variable -
AWS CLI parameter -

Compatibility with AWS SDKS and tools