> For the complete documentation index, see [llms.txt](https://docs.eesel.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.eesel.ai/integrations/shopify.md).

# Shopify

Connect your Agent with Shopify so that it can learn from your product pages, make recommendations, lookup orders, action refunds, and more.

## What you can do

* Look up customer order history and tracking information
* Search and browse your product catalog
* Process returns, refunds, and cancellations
* Generate visual product carousels in chat
* Check product inventory and variant details

## Connecting Shopify

### OAuth (recommended)

Install eesel AI from the Shopify App Store.

1. Go to **Integrations > Shopify**
2. Select **Install Marketplace App**
3. Follow the Shopify installation flow
4. Authorize eesel AI to access your store data

### Access token

Connect with a Shopify Admin API access token.

1. Go to **Integrations > Shopify**
2. Select **Credentials**
3. Enter your shop name and Admin API access token
4. Click **Connect**

## Actions

### Customer and order lookup

| Action                    | Description                                     |
| ------------------------- | ----------------------------------------------- |
| **Get Customer by Email** | Look up customer profile and details            |
| **Get Order History**     | Retrieve a customer's order history by email    |
| **Get Order by ID**       | Get detailed information about a specific order |
| **Get Order Fulfillment** | Check shipping status and tracking information  |

### Product information

| Action                        | Description                                              |
| ----------------------------- | -------------------------------------------------------- |
| **Search Products**           | Search your product catalog by query                     |
| **Get Products**              | Retrieve all products in your store                      |
| **Get Product Variants**      | Get variant details (size, color, SKU, price, inventory) |
| **Get Product Metafields**    | Get custom product metadata                              |
| **Get Variant Metafields**    | Get custom variant metadata                              |
| **Generate Product Carousel** | Create a visual product display in chat                  |

### Order management

| Action            | Description                 |
| ----------------- | --------------------------- |
| **Create Return** | Initiate a product return   |
| **Refund Order**  | Process a refund            |
| **Cancel Order**  | Cancel an unfulfilled order |

## Common scenarios

**"Where's my order?"** Agent looks up the customer by email → gets order history → finds the relevant order → checks fulfillment status → replies with tracking info.

**"I want to return this item"** Agent looks up the order → verifies it's eligible for return → creates a return request.

**"What products do you have for...?"** Agent searches the product catalog → presents relevant products → optionally generates a product carousel in chat.

## Tips

**Pair with a helpdesk.** Shopify works best alongside a helpdesk integration like [Zendesk](/integrations/zendesk.md) or [Gorgias](/integrations/gorgias.md). The agent handles tickets while looking up Shopify data as needed.

**Enable HITL for order management.** Turn on Human in the Loop for sensitive actions like refunds and cancellations.

**Use product carousels in chat.** The Generate Product Carousel action creates a visual product display — great for the [Chat Bubble](/use-cases/website-chat.md) on your website.

## Troubleshooting

**Can't connect?**

* Ensure you have admin access to your Shopify store
* For API token connections, verify the token has the correct scopes

**Product data seems outdated?**

* Product data is fetched in real-time from Shopify, so it should always be current
* If issues persist, try disconnecting and reconnecting


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.eesel.ai/integrations/shopify.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.