S3 Transfer Manager v2 Now Generally Available

[wty-Bryant]

On January 30, 2026, we officially released feature/s3/transfermanager to production, replacing the previous feature/s3/managerutility.

What's New

The new generation Transfer Manager addresses several key issues from the previous version:

• Unified Client: Merged uploader and downloader into a single client, allowing users to transfer objects with shared configuration (concurrency, part size, etc.)
• Improved I/O Handling: Defined new I/O types replacing the old manager's S3 type usage
• Optimized Upload Strategy: Decreased memory allocation when uploading small objects (Issue Upload manager: When using io.Reader without seeking support, the uploader over allocates memory leading to high usage #2694)
• New downloader API: Added new GetObject API which returns object data in a serial io.Reader while retaining the resiliency of part/range-based downloads. See Support for io.Reader Interface in S3 Transfer Manager's Downloader #2247
• Flexible Download Options: Enabled downloading objects in parts or ranges based on configuration
• Modern Checksum Support: Deprecated ContentMD5 checksum in favor of flexible checksum options to guarantee content integrity (Issue manager.Uploader.Upload silently ignores PutObjectInput.ContentMD5 #1040)
• Batch Operations: Added directory-level operations for efficient batch transfers

Available APIs

Transfer Manager v2 implements the following public APIs:

• UploadObject: Enhanced object write support with automatic multipart upload for large objects 
• DownloadObject: Enhanced object read support with automatic multipart download for large objects 
• GetObject:  Mimics s3.GetObject API with sequential io.Reader output and concurrent multipart download 
• UploadDirectory: Enhanced directory write support with automatic concurrent file uploads for folders 
• DownloadDirectory: Enhanced bucket read support with automatic concurrent object downloads

Roadmap

Based on existing feature requests (#2095, #1463), we intend to support following functionalities in the future:

• Multipart copy object
• Key prefix delete objects

[prochac]

The GetObject is great. But could we also get something that returns io.Writer?
Similar to one in GCS SDK.
https://pkg.go.dev/cloud.google.com/go/storage#ObjectHandle.NewWriter

The UploadObject function is blocking and sucks when used for streamed (sequential) upload.

[jobstoit]

@prochac I have this project s3io that does that essentially. I had a PR here a while back too to just get it in the project here but that wasn't accepted at the time. My project does stream concurrently and yet sequential on both Read and Write, hope it helps or gives some inspiration.

[jigish]

Is there a plan to support the CRC64NVME ChecksumAlgorithm for UploadObject? I noticed it is missing from here: https://pkg.go.dev/github.com/aws/aws-sdk-go-v2/feature/s3/[email protected]/types#pkg-constants

[wty-Bryant]

Core s3.PutObject has added support for CRC64NVME, we may add that enum later. For now you can try to directly define it as a string enum like other algorithms

[rohithkumar31]

It's good to provide an option to configure the ChecksumType - FULL_OBJECT or CHECKSUM as CRC algorithms supports both for multipart uploads

[ishepherd]

Are there any docs / examples available?

Will you be updating the https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/go/example_code/s3 ?

[edclement]

Yeah, seems a little premature to deprecate feature/s3/manager without updating examples/docs for feature/s3/transfermanager...

[fari-99]

does anyone have example? 🙏

[sqr]

@fari-99 you can do something like:

    import("github.com/aws/aws-sdk-go-v2/aws"
	"github.com/aws/aws-sdk-go-v2/service/s3"
	"github.com/aws/aws-sdk-go-v2/feature/s3/transfermanager")

	s3Client := s3.NewFromConfig(YourAwsCfg)
	file, _ := os.Open("/your_file")
	defer file.Close()
	tmClient := transfermanager.New(s3Client, func(o *transfermanager.Options) {
		o.PartSizeBytes = 64 * 1024 * 1024
		o.Concurrency = 3
	})
	output, _ := tmClient.UploadObject(context.TODO(), &transfermanager.UploadObjectInput{
		Bucket: aws.String(destinationBucket),
		Key:    aws.String(destinationObject),
		Body:   file,
	})
}

[fari-99]

thank you @sqr 🙏

[fess932]

Please make the options a public field. I need a way to manually set the checksum algorithm without reflection & unsafe.

[SeaRoll]

We can't use the current transfermanager due to this happening all the time: #3323

[shogo82148]

I am looking for a replacement for manager.GetBucketRegion. Does it not exist in the transfermanager?