> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stigg.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Amazon S3

## Overview

Stigg's integration with Amazon S3 allows you to export your product catalog, customer, and subscription data to an S3 bucket as structured files — useful for data lake pipelines, custom ETL workflows, or archival.

<Note>
  Stigg's native data export integrations are included in the Scale plan, and are also available as an optional add-on to the Growth plan. See Stigg's pricing for more details.
</Note>

## Exported entities

When connecting S3, you can choose which Stigg entity groups to include in the sync. All groups are selected by default.

See [Exported entities](./overview#exported-entities) for the full list of entity groups and the tables within each.

<Card title="Entity schema" icon="sitemap" href="./schema" horizontal />

## Setting up the integration

### Prerequisites

* An S3 bucket in your AWS account
* An IAM role that Stigg can assume, with read/write access to the bucket

<Steps>
  <Step title="Create an IAM role for Stigg">
    In the [AWS IAM console](https://console.aws.amazon.com/iam/), create a role with the following S3 permissions on your bucket:

    * `s3:PutObject`
    * `s3:DeleteObject` (only needed to validate the connection during setup — can be removed afterward)

    <Note>
      If your bucket uses KMS encryption, also grant `kms:GenerateDataKey` and `kms:Decrypt` on the KMS key.
    </Note>

    Grant Stigg's AWS account (`arn:aws:iam::STIGG_ACCOUNT_ID:root`) permission to assume this role. Contact [Stigg support](mailto:support@stigg.io) for the current account ID.
  </Step>

  <Step title="Connect Stigg with S3">
    In [Stigg](https://app.stigg.io/), navigate to **Integrations > Apps > Amazon S3**.

    Enter the following information in the connection form:

    | Field                    | Description                                                  |
    | ------------------------ | ------------------------------------------------------------ |
    | Bucket name              | The name of your S3 bucket                                   |
    | Bucket region            | The AWS region where the bucket is located, e.g. `us-east-1` |
    | IAM Role ARN             | The ARN of the IAM role created above                        |
    | Folder prefix (optional) | A path prefix within the bucket where data will be written   |

    Click **Test & connect**.
  </Step>

  <Step title="Select entities to export">
    After entering your connection details, expand the **Entities to export** section to choose which entity groups to include in the sync. All groups are selected by default.

    See [Exported entities](./overview#exported-entities) for a description of each group.
  </Step>
</Steps>

## Sync process and schedule

After setup, Stigg performs a full sync of all selected entities. Subsequent syncs are incremental, transferring only changes since the last run.

Stigg syncs data on a configurable schedule — daily at 12:00 AM UTC by default. You can adjust the sync frequency from the integration settings at any time.

## Manual sync

To trigger an immediate sync, open the S3 integration in [Stigg](https://app.stigg.io/) and click **Sync now**.

## Sync history

The integration page shows a log of all past and in-progress syncs. The dashboard updates automatically as syncs complete.

Each row shows the sync status and timestamps. Expand a row to see rows synced per entity, sync duration, trigger source, and who initiated it.

Use the status and date filters to find a specific sync run.

## Removing the integration

To remove the integration, click on the dotted menu icon and select the **Remove** action.

Confirm the action by clicking on the **Remove** button in the opened modal.