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

# Shopify

> Let the Dema Agent query products, orders, customers, and inventory from your Shopify store.

## Overview

Once Shopify is connected, the Dema Agent can query products, orders, customers, and inventory from your Shopify store through the Admin GraphQL API. Useful for pulling live commerce data into an analysis and for light write actions such as updating customer records, discounts, and product publications.

***

## Prerequisites

* A Shopify store you own, or staff access with permission to manage and install apps.
* Access to the [Shopify Dev Dashboard](https://dev.shopify.com/dashboard) to create the app.

<Note>
  Shopify requires you to create your own app and paste its credentials into Dema. You only need to do this once per store. When the Dev Dashboard asks how to distribute the app, choose **Custom distribution** — it is for an app installed on a single store you own and is not listed on the App Store.
</Note>

***

## Connect Shopify

<Steps>
  <Step title="Create an app in the Shopify Dev Dashboard">
    1. Open the [Shopify Dev Dashboard](https://dev.shopify.com/dashboard) and go to **Apps → Create app**.
    2. Give the app a recognizable name, for example `Dema Agent`.
    3. Choose **Custom distribution** and select the store you want to connect.
  </Step>

  <Step title="Add the app URL, redirect URL and scopes in a new version">
    Shopify app **versions are immutable** — to set or change the URLs or scopes, you create a new version based on the current one and release it. Changing them later works the same way.

    1. Open the app and click **Create version**.
    2. Under **Access → Scopes**, enter the scopes listed under [Scopes Dema requests](#scopes-dema-requests) below as a comma-separated list.
    3. Under **Access → Redirect URLs**, add `https://app.dema.ai/agents/oauth/callback`.
    4. Under **URLs → App URL**, enter the **same value again**. Shopify only starts the install when the App URL and the redirect URL are on the same domain, and leaving your own website or Shopify's placeholder here is the most common reason connecting Shopify fails.
    5. Click **Release** to make the version active.

           <img src="https://mintcdn.com/demaai/0GNMskf_4RXwG1m-/images/shopify-app-url-redirect-url.png?fit=max&auto=format&n=0GNMskf_4RXwG1m-&q=85&s=97cc7dea2ee022149f602df18fde6a41" alt="Shopify app configuration with App URL and Redirect URLs both set to https://app.dema.ai/agents/oauth/callback" width="757" height="296" data-path="images/shopify-app-url-redirect-url.png" />

    <Note>
      Clicking this app's tile inside your Shopify admin will now open a Dema page rather than an app home screen. That is expected: the app exists only to authorize Dema's connection to your store.
    </Note>
  </Step>

  <Step title="Copy the app credentials">
    In the app's **Settings**, copy the **Client ID** and **Client secret**.
  </Step>

  <Step title="Paste the credentials into Dema">
    In Dema, go to **Agents → Settings → Integrations**, find **Shopify**, and click **Connect**. Enter:

    * **Client ID** from Shopify
    * **Client secret** from Shopify
    * **Account URL** in the form `https://{store}.myshopify.com`, replacing `{store}` with your store's subdomain

    Click **Add**. Shopify will ask you to install the app on the store. Approve it and you are returned to Dema with the integration marked as Active.
  </Step>
</Steps>

***

## Scopes Dema requests

| Scope                                     | What it allows                                              |
| ----------------------------------------- | ----------------------------------------------------------- |
| `read_products`, `write_products`         | Read and update products and variants                       |
| `read_orders`, `write_orders`             | Read and update orders                                      |
| `read_customers`, `write_customers`       | Read and update customer records and tags                   |
| `read_inventory`                          | Read inventory levels                                       |
| `read_locations`                          | Read store locations, used for per-location inventory views |
| `read_publications`, `write_publications` | Read and update product publications across sales channels  |
| `read_discounts`, `write_discounts`       | Read and update discounts and promotions                    |

<Note>
  By default `read_orders` returns only the last 60 days of orders. Older orders require the `read_all_orders` scope, which Shopify must approve separately — it is not requested here.
</Note>

***

## When the connection expires

Dema uses expiring offline tokens. The access token lasts about an hour and Dema refreshes it automatically (the refresh token is valid 90 days and rotates on each refresh). If Dema stays disconnected past the refresh window, or you uninstall the app in Shopify, the connection lapses — reconnect from **Agents → Settings → Integrations → Shopify**.

***

## Troubleshooting

* **`The redirect_uri and application url must have matching hosts`.** Your app's **App URL** is not on the same domain as the redirect URL. Create a new version, set both **URLs → App URL** and **Access → Redirect URLs** to `https://app.dema.ai/agents/oauth/callback`, and release it.
* **Redirect URI mismatch.** The redirect URI in your Shopify app must be `https://app.dema.ai/agents/oauth/callback` exactly, including protocol and path.
* **Dema says the store URL is invalid.** The account URL must be HTTPS and must end with `.myshopify.com`. Use your store's real subdomain, not a custom domain.
* **Install fails on the store.** The staff account installing the app needs a role with permission to manage and install apps. Store owners can adjust staff permissions in the store admin under **Settings → Users and permissions**.

***

## Additional resources

* [Shopify: create apps using the Dev Dashboard](https://shopify.dev/docs/apps/build/dev-dashboard/create-apps-using-dev-dashboard)
* [Shopify Admin API access scopes](https://shopify.dev/docs/api/usage/access-scopes)
* [Shopify offline access tokens](https://shopify.dev/docs/apps/build/authentication-authorization/access-tokens/offline-access-tokens)