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

# Shopify

> Connect your Shopify store to Adapt to analyze orders, products, customers, and revenue

Connect Shopify to Adapt using a custom app's Admin API access token so Adapt can read your store data.

## Set up credentials

<Steps>
  <Step title="Open the Develop apps area">
    In your Shopify admin, go to **Settings > Apps and sales channels > Develop apps**.
  </Step>

  <Step title="Enable custom app development">
    If prompted, click **Allow custom app development** and confirm. This is a
    one-time action per store and requires the store owner or a staff account
    with the right permissions.
  </Step>

  <Step title="Create the app">
    Click **Create an app**, give it a name (for example, "Adapt"), select an
    app developer, and click **Create app**.
  </Step>

  <Step title="Configure Admin API scopes">
    Open the **Configuration** tab, then under **Admin API integration** click
    **Configure**. Select the read scopes you need, such as `read_orders`,
    `read_products`, and `read_customers`, then click **Save**.
  </Step>

  <Step title="Install the app">
    Open the **API credentials** tab and click **Install app**, then confirm.
    Installing the app generates the Admin API access token.
  </Step>

  <Step title="Reveal and copy the access token">
    Under **Admin API access token**, click **Reveal token once** and copy the
    value. It starts with `shpat_`. Shopify shows this token only one time, so
    store it securely.
  </Step>

  <Step title="Note your store domain">
    Your store domain is the `.myshopify.com` address for your shop, for example
    `my-store.myshopify.com`.
  </Step>
</Steps>

<Note>
  Shopify is migrating new app creation to the Dev Dashboard and Shopify CLI.
  The **Develop apps** flow in the admin remains available on many stores where
  custom app development is enabled and is what produces a long-lived `shpat_`
  Admin API access token. If you do not see this option, create the app from the
  Dev Dashboard instead.
</Note>

## Connect to Adapt

<Steps>
  <Step title="Open Integrations">
    In Adapt, go to **Settings > Integrations**.
  </Step>

  <Step title="Find Shopify">
    Search for **Shopify** and select it from the catalog.
  </Step>

  <Step title="Start the connection">
    Click **Connect** to open the connection form.
  </Step>

  <Step title="Add your credentials">
    Enter the values you gathered above, then click **Add connection**:

    | Secret Name                  | Value                                           |
    | ---------------------------- | ----------------------------------------------- |
    | `SHOPIFY_STORE_DOMAIN`       | Your store domain (e.g. my-store.myshopify.com) |
    | `SHOPIFY_ADMIN_ACCESS_TOKEN` | Your Admin API access token                     |

    You can rename the connection and choose whether it is shared with your
    organization or kept personal to you.
  </Step>

  <Step title="Test the connection">
    Ask Adapt to list your most recent orders.
  </Step>
</Steps>

### Security

* Credentials are encrypted at rest with AES-256
* Grant only the read scopes you need when configuring Admin API access
* The Admin API access token is shown only once at install time; store it securely
* Uninstalling or deleting the custom app revokes the token
* Never share your access token or commit it to source control

## Capabilities

Adapt can read and analyze your Shopify store data through the Admin API. Ask
questions about sales performance, catalog, and customers in natural language.

### Examples

```
Show total revenue by month for the last year
```

```
Which 10 products generated the most sales this quarter?
```

```
How many new customers did we get last month?
```

```
Compare order volume this week to the same week last year
```