Amazon S3 Files for Confluence

Atlassian Approved for Confluence Data Center on 2019-09-20

Helps to Store, manage, versioning and centralize space or project related files or documents on Amazon AWS S3 bucket.



If your upgrading from older than version 2.0.2, please re-update the bucket configuration.


Quick Start Steps


Go to General Configuration → Configure Amazon S3 Buckets.


  • Access Secret Keys are not required If you are Confluence is hosted on AWS EC2.

    • You can attach S3 role to EC2 with read and write access

    • If you are bucket is on different account then use Bucket policy to grant permission to Confluence Hosted account.

  • For Access Secret Keys two ways to get i.e.



Go to page options i.e. Click (…) → Amazon S3 Files

Attach existing files or upload new one.

Attach / Link existing Amazon S3 File to Space via REST API.

1 2 3 4 5 % curl -u admin -XPOST "http://localhost:8090/rest/spaces3documents/1.0/utility/attach/document" \ -H "Content-Type: application/json" --data '{"bucketConfigId": 4, "spaceKey": "DT", \ "pageId": 4816905, "documentKey": "s3://ilaesolution/documents/DT/pom.xml"}' {"status":19,"message":"Amazon S3 File has been attached to Space. File ID #19"} %

Upload new Amazon S3 File via REST API.

1 2 3 4 % curl -u admin -XPOST "http://localhost:8090/rest/spaces3documents/1.0/utility/upload/document" \ -H "X-Atlassian-Token: no-check" -F bucketId=4 -F pageId=4816905 -F file=@/tmp/pom.xml {"status":0,"message":"Space S3 File Upload Successful. (documents/DT/pom.xml)"} %

To overwrite: -F updateDocument=true



Go to page Edit → Add Amazon S3 File Link or Amazon S3 Files Summary macros.




For Debug. Go to, Logging and profiling → Add new entry

1 2 Package / Class Name: com.tse.confluence.spaces3documents.plugin Logging Level: DEBUG