---
title: "s3 upload · RUAL Documentation"
description: "Uploads an object to Amazon S3."
canonical: https://docs.rual.nl/block-types/amazon%20aws/awsconnection_s3_upload
language: en
---

[Cluster](https://docs.rual.nl/cluster)

[Blocks](https://docs.rual.nl/block-types)

[Interfaces](https://docs.rual.nl/interfaces)

[Blueprints](https://docs.rual.nl/blueprints)

[Tutorials](https://docs.rual.nl/tutorials)

[Home automation](https://docs.rual.nl/home-automation)

[Examples](https://docs.rual.nl/examples)

[Reference](https://docs.rual.nl/reference)

[Architecture](https://docs.rual.nl/architecture)

[Troubleshooting](https://docs.rual.nl/troubleshooting)

Other

# s3 upload

This block is part of the [`amazon aws`](https://docs.rual.nl/block-types/amazon%20aws) group and was last modified in core [`v10.4.28`](https://docs.rual.nl/core-versions/100428).

Uploads an object to Amazon S3.

- connection required `awsconnection` The AWS connection to use for uploading the object

- bucket required `value` The S3 bucket where the object will be stored

- key required `value` The full file path on the S3 bucket

- ACL required `value` Access Control List for the uploaded object. Possible values: private, public-read, public-read-write, authenticated-read, aws-exec-read, bucket-owner-read, bucket-owner-full-control. Default value: private

Default `private`

- File required `file` The file(s) to be uploaded to Amazon S3. Supports multiple files - each file will be uploaded individually.

- metadata required `object` A map of metadata to store with the object in S3. Metadata format: { : }

- cache control `value` Optional parameter to specify caching behavior along the request/reply chain.

- connection `awsconnection` The AWS connection used for the upload

- success `condition` Condition indicating whether all files were successfully uploaded to S3

- error `value` Error message in case of any issues during the upload process

- uploaded files `array` Array of successfully uploaded files with metadata including: originalName, s3Key, size, contentType, etag, location

- failed files `array` Array of files that failed to upload with error information: originalName, error

A typical wiring for [s3 upload](https://docs.rual.nl/block-types/amazon%2520aws/awsconnection_s3_upload): the `connection` out pin feeds [s3 list](https://docs.rual.nl/block-types/amazon%2520aws/awsconnection_s3_list).

[![Studio canvas example for the s3 upload block: typical wiring for s3 upload.](https://docs.rual.nl/canvas-examples/awsconnection_s3_upload.png)](https://docs.rual.nl/canvas-examples/awsconnection_s3_upload.png?v=3)

## Version history

Introduced in [`v10.4.28`](https://docs.rual.nl/core-versions/100428).

- [Back to `amazon aws`](https://docs.rual.nl/block-types/amazon%20aws): Return to the main group to view all sub-groups

- [Back to `amazon aws`](https://docs.rual.nl/block-types/amazon%20aws?group=amazon%20aws): Return to the group to view all blocks within this group

Was this page helpful? [Tell us what to improve](https://docs.rual.nl/support) · RUAL Docs is an integral component of the [RUAL ecosystem](https://rual.nl)