# Shopify actions

> Connect your Shopify store so the agent can look up orders and products in real time. Set up the connector once, then enable order-status and product-search actions for grounded, live answers.

The Shopify connector lets your agent answer the two questions ecommerce customers ask most: *"Where's my order?"* and *"Do you have this?"* — using live data from your store rather than a static FAQ.

Shopify is an `integration`-type connector. You authenticate once in [Integrations](/docs/integrations/shopify), then enable the specific Shopify actions you want on each agent.

> **CONNECTOR CREDENTIALS:** The Shopify connector authenticates with your store domain (`shop`) and an `access_token`. Store these once as a Shopify integration — they're shared by every Shopify action across your agents.

## Available actions

| Action | What it does | Parameters |
| --- | --- | --- |
| `get_orders` | Retrieve order status and history. | `order_number`, `email` |
| `get_products` | Search and display products from the catalog. | `query` |

These cover the core support flows: a customer asks where their order is, the agent calls `get_orders` with their order number or email and reports the status; a shopper asks about a product, the agent calls `get_products` and surfaces matching items.

## Set it up

1. **Connect Shopify** — In Integrations, add the Shopify connector with your store domain and access token. See the Shopify integration guide for the exact scopes.
2. **Enable the actions** — On your agent's Actions tab, add the Shopify connector and enable get_orders and get_products.
3. **Choose execution mode** — Both actions are read-only lookups, so auto mode is safe — no confirm step needed.
4. **Test and refine** — Run each action with a real order number and a sample product query to confirm the data comes back as expected.

> **RENDER RESULTS AS WIDGETS:** Pair Shopify actions with [interactive widgets](/docs/widgets/overview) to show an order-status card or a product carousel inline in the chat instead of plain text.

## Grounding order answers

> **CHECK:** Because order status comes straight from Shopify, the agent reports the real, current state — not a paraphrase. Combine this with a Q&A pair for your *shipping policy* so the agent explains both "where it is" and "what to expect."

## FAQ

**What credentials does the connector need?**

A store domain (shop) and an access token. Add them as a Shopify integration; they are reused by every Shopify action.

**Can a customer look up an order without an order number?**

Yes — get_orders accepts an email as well, so the agent can find recent orders by the email on file.

**Do Shopify actions need the confirm gate?**

No. get_orders and get_products are read-only, so they're safe to run in auto mode.

**Can the agent modify or cancel orders?**

The built-in Shopify actions are read-only lookups. To take a write action, build a [custom action](/docs/actions/custom-action) against the Shopify Admin API and keep it in confirm mode.

## What's next

- [Shopify integration](/docs/integrations/shopify) — Connect your store and set the right scopes.
- [Widgets overview](/docs/widgets/overview) — Render order and product results as interactive cards.
- [Custom action](/docs/actions/custom-action) — Go beyond lookups with the Shopify Admin API.