multipart_threshold - AWS SDKs and Tools


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

Specifies the size threshold that the AWS CLI uses to trigger Amazon S3 multipart transfers of individual files.


When uploading, downloading, or copying a file, the aws s3 commands switch to multipart operations if the file exceeds this 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: KB, MB, GB, or TB. For example, 300KB or 10MB.


Amazon S3 can impose limits on valid values that can be used for multipart operations. For more information, see the S3 Multipart Upload documentation in the Amazon Simple Storage Service Developer Guide.

Ways to set this value

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

Compatibility with AWS SDKS and tools