# Shopify skills

> 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 skills 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 skills 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 skill across your agents.

## Available skills

| Skill | 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. **Add a Shopify skill** — On your agent's Skills tab, add a Shopify skill (Order Lookup or Product Recommendations) from the marketplace.
2. **Enter your store credentials** — In the add dialog, paste your store domain (your-store.myshopify.com) and an Admin API access token. The access token is encrypted at rest and never shown back. See the Shopify integration guide for the exact scopes.
3. **Choose execution mode** — Both skills are read-only lookups, so auto mode is safe — no confirm step needed.
4. **Test and refine** — Run each skill with a real order number and a sample product query to confirm the data comes back as expected.

> **RENDER RESULTS AS WIDGETS:** Pair Shopify skills 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 Admin API access token. You enter them when you add a Shopify skill; the token is encrypted at rest and never shown back.

**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 skills 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 skills are read-only lookups. To take a write skill, build a [custom skill](/docs/skills/custom-skill) 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 skill](/docs/skills/custom-skill) — Go beyond lookups with the Shopify Admin API.