# Shopify

> Connect Shopify to ground your agent in your catalog and enable live order-status, tracking, and returns lookups — plus install the chat widget on your storefront.

Shopify is the integration that turns Bookbag from a generic FAQ bot into a real ecommerce support agent. It does three things: it grounds answers in your store's content, it powers live order lookups through actions, and it deploys the chat widget on your storefront.

> **THE ECOMMERCE TRIFECTA:** For a Shopify store, set up all three: connect the data, enable Shopify actions, and install the widget. That combination resolves the bulk of "where is my order?" and "can I return this?" tickets automatically.

## What you can do

| Capability | What it enables |
| --- | --- |
| Ground in store content | Index policies, product pages, and your help center so answers reflect your actual store. |
| Order-status lookups | The agent looks up an order and tells the customer where it is and when it will arrive. |
| Tracking & shipping | Surface tracking links and shipping estimates in the conversation. |
| Returns & exchanges | Walk customers through your returns policy and start the process. |
| Storefront widget | Embed the chat bubble on every page of your Shopify theme. |

## Ground your agent in store content

Add your store as a [data source](/docs/agents/data-sources): crawl your storefront and help center so policies, FAQs, and product information are indexed. Pin high-stakes answers like your returns window as [Q&A pairs](/docs/getting-started/best-practices) so the agent quotes them exactly.

## Enable order lookups with actions

Live order data comes from [Shopify actions](/docs/actions/shopify). With actions enabled, the agent can look up a customer's order and answer status, tracking, and fulfillment questions in real time instead of guessing.

> **VERIFY IDENTITY FOR ORDER DATA:** Order details are personal data. Use [identity verification](/docs/developers/identity-verification) on the widget so the agent only reveals order information to the right customer.

## Install the storefront widget

Add the chat widget to your Shopify theme so customers can ask questions on any page. Paste the embed snippet before `</body>` in your `theme.liquid` layout:

```liquid
  <script
    src="https://app.bookbag.ai/widget/embed"
    data-agent-id="YOUR_AGENT_ID"
    defer
  ></script>
</body>
```

See [Website widget → Install on Shopify](/docs/deploy/web-widget) for the full step-by-step.

## What's next

- [Shopify actions](/docs/actions/shopify) — Order status, tracking, and returns lookups.
- [Website widget](/docs/deploy/web-widget) — Install the chat bubble on your storefront.
- [Identity verification](/docs/developers/identity-verification) — Safely reveal order data to the right customer.
