> ## 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.

# Google Cloud Storage

## Overview

Stigg's integration with Google Cloud Storage (GCS) allows you to export your product catalog, customer, and subscription data to a GCS 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 GCS, 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

* A Google Cloud Storage bucket
* A GCP [service account](https://cloud.google.com/iam/docs/service-account-overview) with the **Storage Object Admin** role on your bucket

<Steps>
  <Step title="Create a service account and grant access">
    In the [GCP console](https://console.cloud.google.com/iam-admin/serviceaccounts), create a service account for Stigg. Grant it the **Storage Object Admin** role (`roles/storage.objectAdmin`) on your GCS bucket.

    Note the service account email address — you'll need it when connecting.
  </Step>

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

    Enter the following information in the connection form:

    | Field                 | Description                                                                                |
    | --------------------- | ------------------------------------------------------------------------------------------ |
    | Bucket name           | The name of your GCS bucket                                                                |
    | Folder name           | The folder path within the bucket where data will be written. Use `.` for the bucket root. |
    | Service account email | The email address of the GCP service account, e.g. `name@project.iam.gserviceaccount.com`  |

    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 GCS 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.
