Data Types

File Sources AWS S3 Bucket

Upload, download, and process files in your own AWS S3 bucket(s) by creating "AWS S3 Storage" file sources.


Own and manage the AWS S3 bucket your files are stored in.

No storage charge for files stored in AWS S3 buckets. *


You will still be required to pay the full price of your Upload Plan, which includes built-in storage as standard. Your AWS S3 bucket is allowed to grow without limits, and won't incur additional charges from Upload, regardless of its size.


Please note the following when using AWS S3 buckets:

  • Only AWS S3 buckets and DigitalOcean Spaces are supported:

    • MinIO buckets are not supported.

  • Storage usage for AWS S3 buckets is not reported in the Upload Dashboard.

  • Requests to transform files from AWS S3 may incur additional latency due to internal download operations:

    • Video and audio transformations will incur an additional latency of ~1 second per 75MB of input file size when using AWS S3.*

    • Image transformations from AWS S3 do not incur latency: the performance is the same as using Upload's Built-in Storage.


Applies to the first request only: once the result is cached all subsequent requests to the same URL will return near-instantly.

Let's get started...

To use your own AWS S3 bucket as read/write storage for your Upload account:

  1. Create an S3 bucket in AWS (if you haven't already).

  2. Create an AWS access key + secret access key pair.

    This key pair must have read/write access to the S3 bucket.

  3. Create a folder in the Upload Dashboard.

  4. Edit the folder's settings.

  5. Click on "Storage Settings".

  6. Change "Storage Type" to "AWS S3".

  7. Follow the instructions on the form that appears.

  8. Click on "Save Changes".

For reference, the "Storage Settings" section of the "Folder Settings" page is shown below:

Configuring an AWS S3 bucket

Next steps

These pages may also be helpful:

Was this section helpful? Yes No

You are using an outdated browser.

This website requires a modern web browser -- the latest versions of these browsers are supported: