# Amazon S3

<figure><img src="/files/91XHhefSeqc2ArMp1Z8p" alt="" width="563"><figcaption></figcaption></figure>

Connect to a bucket in [Amazon S3](https://aws.amazon.com/s3/) to browse and visualize your vector and/or raster data in Felt.

{% hint style="success" %}
This feature is only available to customers on the [Enterprise plan](https://felt.com/pricing). To upgrade, [contact sales](https://felt.com/sales).
{% endhint %}

1. Open **New data source** — from the workspace homepage, click **+** next to **Data sources**. Or from a map, click ![](/files/qv8POfyKJ00VfTgugMR2) in the toolbar and choose **+ New data source**.
2. Select `Amazon S3`
3. Fill in the `Connection Details`
   1. `Source Name`: name of the source in Felt
   2. `GS URI`: a URL to a bucket in Amazon S3, such as `s3://my-storage-bucket/my_prefix`. If the URL contains a prefix (in this example, `my_prefix`, Felt will only search for objects that start with it.
   3. `Credentials`: see the following [**Authentication**](#authentication) section.
4. Click `Connect`
5. Once connected you will see a catalog of your data with previews for your new source
6. From here you can add any of these layers to your spatial dashboards!

### Authentication

For private S3 buckets, you will need to allow Felt to [assume an IAM role](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) on your account:

* Create a [policy](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) that allows listing and reading objects in the S3 buckets where your assets are located. It should be able to perform the following actions:
  * `s3:GetObject`
  * `s3:GetObjectVersion`
  * `s3:ListBucket`
  * `s3:GetBucketLocation`
* Create [an IAM role](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) and attach the aforementioned policy to it.
* Create a Trust Relationship for said role that allows Felt to access your assets. Make sure to include all the principals listed below:

```json
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "AWS": [
                    "arn:aws:iam::949302143999:root",
                    "arn:aws:iam::452667257775:root",
                    "arn:aws:iam::375127086520:root",
                    "arn:aws:iam::033636008376:root"
                ]
            },
            "Action": "sts:AssumeRole"
        }
    ]
}
```

### Supported file formats

Felt can read in spreadsheet, vector, and raster files from cloud storage connections. To see file formats supported see [Files](/upload-anything/files.md) in our [Upload Anything](/upload-anything/files.md)section.

{% hint style="success" %}
To skip Felt's data processing and stream in large, high-resolution raster files as cloud-optimized geotiffs directly from your cloud source, see [Raster infrastructure](/data-sources/raster-infrastructure.md).
{% endhint %}

### Raster metadata extraction

Felt can extract metadata properties from the filepaths to objects in your bucket. Learn more about Felt's Raster Infrastructure feature in [Organizing your raster data](/data-sources/raster-infrastructure/organizing-your-raster-data.md).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.felt.com/data-sources/cloud-sources/amazon-s3.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.