# Shopify

> Connect your client stores so agents work with real theme code and storefront context instead of guessing.

_CommerceCopilot documentation · Integrations_

CommerceCopilot is built for Shopify agencies, and the Shopify integration is how agents see the store they are working on: the live theme, its structure, and how it changes over time. Connected stores give the Developer agent real theme code to work against and keep every agent's picture of the storefront current.

## What CommerceCopilot uses Shopify for

- **Theme access.** The Developer agent reads and writes themes on the connected store, which is what lets it deliver storefront work, not just describe it.
- **Storefront snapshots.** CommerceCopilot keeps a snapshot of the store's shape (theme, locales, published state) and refreshes it automatically when the store changes, so agents never plan against a stale storefront.

## Connect a store

Stores connect one at a time, since Shopify authorizes per store rather than per account:

1. Go to **Settings** in the sidebar and find the **Shopify** card.
2. Enter the store's domain (for example `mystore.myshopify.com`) and click **Connect a store**.

![The Shopify card on the Settings page with a store domain field and Connect a store button](/docs/integration-shopify.png)

3. Shopify's authorization screen opens for that store. Approve the requested theme access.
4. Repeat for each client store you want available. Agencies typically connect several; they all appear on the card.

> **Prerequisite:** you need staff access to the store with permission to manage apps. On client stores, that usually means a collaborator account with the app management permission.

## Bind a store to a project

1. Open the project and go to **Settings**, then **Integrations**.
2. In the **Shopify Store** card, select the connected store this project is for. Development stays paused until one is connected.
3. Add a **Storefront Access Token**. Install Shopify's free **Theme Access** app on the store, generate a token (it starts with `shptka_`), and paste it here. This token is what lets agents preview the storefront the way a customer sees it.
4. If the store's online storefront is password-protected (common for pre-launch builds), add the store password too, so agents can get past the gate.

## Staying in sync

After connection, CommerceCopilot subscribes to the store's change events. Publishing a theme, editing theme code, changing locales, or updating shop settings triggers a snapshot refresh for the linked projects. Deliberately, routine catalog churn (orders, inventory, product edits) does not: agents care about the storefront's shape, not every transaction.

## Troubleshooting

- **The store will not connect.** Confirm the domain is the `.myshopify.com` address, not the custom domain, and that your account can manage apps on that store.
- **Agents cannot preview the storefront.** Check the Storefront Access Token on the project, and add the store password if the online store is password-protected.
- **The app was uninstalled from the store.** CommerceCopilot notices automatically. Reconnect the store from the Settings card when you are ready.

## Next steps

- [GitHub](/docs/github) for the theme repository
- [Figma](/docs/figma) for the designs the storefront is built from

---
Canonical page: https://www.commercecopilot.ai/fr/docs/shopify