S3 Uploads
Learn how to upload files to Supabase Storage using S3.
You can use the S3 protocol to upload files to Supabase Storage. To get started with S3, see the S3 setup guide.
The S3 protocol supports file upload using:
- A single request
- Multiple requests via Multipart Upload
Single request uploads
The PutObject action uploads the file in a single request. This matches the behavior of the Supabase SDK Standard Upload.
Use PutObject to upload smaller files, where retrying the entire upload won't be an issue. The maximum file size on paid plans is 5 GB.
For example, using JavaScript and the aws-sdk client:
_14import { S3Client, PutObjectCommand } from '@aws-sdk/client-s3'_14_14const s3Client = new S3Client({...})_14_14const file = fs.createReadStream('path/to/file')_14_14const uploadCommand = new PutObjectCommand({_14 Bucket: 'bucket-name',_14 Key: 'path/to/file',_14 Body: file,_14 ContentType: 'image/jpeg',_14})_14_14await s3Client.send(uploadCommand)
Multipart uploads
Multipart Uploads split the file into smaller parts and upload them in parallel, maximizing the upload speed on a fast network. When uploading large files, this allows you to retry the upload of individual parts in case of network issues.
This method is preferable over Resumable Upload for server-side uploads, when you want to maximize upload speed at the cost of resumability. The maximum file size on paid plans is 50 GB.
Upload a file in parts
Use the Upload class from an S3 client to upload a file in parts. For example, using JavaScript:
_15import { S3Client } from '@aws-sdk/client-s3'_15import { Upload } from '@aws-sdk/lib-storage'_15_15const s3Client = new S3Client({...})_15_15const file = fs.createReadStream('path/to/very-large-file')_15_15const upload = new Upload(s3Client, {_15 Bucket: 'bucket-name',_15 Key: 'path/to/file',_15 ContentType: 'image/jpeg',_15 Body: file,_15})_15_15await uploader.done()
Aborting multipart uploads
All multipart uploads are automatically aborted after 24 hours. To abort a multipart upload before that, you can use the AbortMultipartUpload action.