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

# Shopify

> Connect your Shopify store so AdStellar can see real orders, revenue, and AOV — plus troubleshooting for connection issues.

Connecting Shopify lets the AdStellar agent ground its analysis in your **real store data** — actual orders, revenue, and average order value — instead of only what Meta reports. It also unlocks conversion-aware recommendations (for example, holding off on a Sales-optimized campaign until your pixel has purchase signal).

## Connect your store

<Steps>
  <Step title="Open Integrations">
    Click **Integrations** in the left sidebar (or **Set up Connectors** from the Setup page).
  </Step>

  <Step title="Find Shopify">
    It's under the **Ecommerce** category, or type "Shopify" in the search box.
  </Step>

  <Step title="Click Connect and sign in">
    A secure Shopify window opens. Sign in with a Shopify account that has **store owner or admin** access, and approve the connection.
  </Step>

  <Step title="Wait for the Connected badge">
    After you approve, the AdStellar side finishes the handshake — this normally takes **a few seconds, and at most two minutes**. When the card shows a **Connected** badge, you're done.
  </Step>
</Steps>

<Note>
  **You do not need to pick any Access Scopes manually.** The connection flow requests exactly the read permissions it needs (orders, revenue) automatically — if Shopify shows you a permissions screen, just approve it as-is.
</Note>

## Troubleshooting

### The window says "Shopify isn't loading right now" or spins forever

The connection handshake now **times out after 2 minutes** with a clear error instead of spinning indefinitely. If it times out or Shopify shows a connection error:

1. **Close the window and retry once.** Transient Shopify hiccups are the most common cause.
2. **Sign in as the store owner or an admin** — staff accounts without app-install permission can log in but can't authorize the connection.
3. **Disable popup blockers / ad blockers** for `app.adstellar.ai`, or retry in an incognito window (rules out extension conflicts).
4. **Use your `yourstore.myshopify.com` address** when Shopify asks for the store, not your custom domain.

### Still stuck?

If the connection fails twice in a row, contact us via the in-app chat and include:

* Your store's `.myshopify.com` address
* What you saw (error message, timeout, or infinite spinner)
* The browser you used

The support agent will file it directly with engineering with that context attached.

## What the agent can do once connected

Ask in plain language and the agent uses your real store data automatically:

* *"What was my real Shopify revenue last week vs. what Meta reported?"*
* *"What's my AOV this month?"*
* *"Which campaign drove the most actual orders?"*

See [Connectors & Custom MCP](/integrations/connectors) for tool permissions and workspace access controls.