# Amazon AWS S3

> Translation connector for your cloud hosted files

URL: https://store.crowdin.com/s3_integration_app
Category: Development, File Management & Storage
Type: App
Author: Crowdin

Translate your Amazon AWS S3 content with ease. Setup integration once, define your localization workflow and spend less time managing translations.

> Amazon S3 bucket is a public cloud storage resource available in Amazon Web Services' (AWS) Simple Storage Service (S3), an object storage offering.

## Features at a glance


 - Quick translation of your files stored at Amazon AWS S3.
 - Manual content synchronization before and after translation.
 - Auto-sync of source content and translations.
 - WYSIWYG file preview for translators.
 - Quick sync and translation of even minor content updates, like a new sentence or a changed word.

## Setting up the Amazon AWS S3 connector


After installing the application, you will find it in your project *Integrations* section.


Follow the instructions on the screen to connect your Amazon AWS S3 account.

![Amazon AWS S3 configuration](https://developers.app.crowdin.net/api/media/file/d02be10a-698c-4852-bd33-285af221ee18.png)

## Manual synchronization


To import content for translation from Amazon AWS S3, follow these steps:


 1. Open the Amazon AWS S3 integration.
 2. In the Amazon AWS S3 section (right panel), select the files that should be translated.
 3. Click Sync.


To export translations to Amazon AWS S3, follow these steps:


 1. Open the Amazon AWS S3 integration.
 2. In the left section, select the files that will be synced to Amazon AWS S3.
 3. Click Sync to Amazon AWS S3.

![Amazon AWS S3 translation synchronization to Crowdin](https://developers.app.crowdin.net/api/media/file/64597192-5dbf-4a26-bb8e-c671232b5382.png)

## Auto content synchronization


To automatically import content for translation from Amazon AWS S3 choose files and click Scheduled sync in the right panel in the Amazon AWS S3 integration. The file you chose will be pushed once at a scheduled time (by default, it is done once a day). The same button is used to export translated files from Crowdin to Amazon AWS S3 (in the left panel). You may disable this by clicking Disable Sync.

The following minimum permissions on the AWS side are required:

- ListBucket
- DeleteObject
- GetObject
- PutObject
- PutObjectACL
- ListAllMyBuckets

Example policy:

```
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "s3:ListBucket",
                "s3:DeleteObject",
                "s3:GetObject",
                "s3:PutObject",
                "s3:PutObjectAcl"
            ],
            "Resource": [
              "arn:aws:s3:::<BUCKET_NAME>/*",
              "arn:aws:s3:::<BUCKET_NAME>"
            ]
        },
        {
            "Effect": "Allow",
            "Action": "s3:ListAllMyBuckets",
            "Resource": "arn:aws:s3:::*"
        }
    ]
}
```

![Sync translated files back to Amazon AWS S3](https://developers.app.crowdin.net/api/media/file/4b43f345-6225-48f7-9922-9d5f4809268a.png)