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

# See Shopify orders inside Helpdesk tickets

> See a customer's Shopify order history right inside the ticket.

The **Shopify Orders** panel shows a customer's Shopify order history in the ticket sidebar of the Chatbase Helpdesk. It's for support teams at Shopify stores who answer order questions, such as tracking, returns, and address checks, and want the order in front of them while they reply. The panel appears on tickets for any AI agent connected to a Shopify store, so you don't need to open Shopify in another tab.

Use it to check what a customer bought, confirm a shipping address, look up tracking, or jump straight to the order in Shopify admin while you reply.

> [!NOTE]
>
> The panel only shows up when a **Shopify integration** is connected to this AI agent. If you don't see it, connect your store first. See the [Shopify integration guide](https://chatbase.co/docs/user-guides/integrations/shopify.md).

## How orders are matched

The panel looks up orders using the ticket contact's details, in this order:

1. **Email**: the contact's email address is tried first.
2. **Phone**: if no orders are found by email (or there's no email on file), it falls back to the contact's phone number.

### Looking up a different customer

Sometimes the ticket contact isn't the same person who placed the order (for example, they wrote in from a different email). Use the **lookup field** at the top of the panel to search by a different email or phone number.

* Edit the field and confirm to run a new search.
* Click **Reset to ticket contact** to go back to the ticket contact's original details.

## The order list

Each order shows a summary card with:

* **Order number** (e.g. `#1024`) and the date it was placed
* **Total price**
* **Status badge** for fulfillment (unfulfilled, partially fulfilled, fulfilled)

![A Helpdesk ticket about an exchange request, with the Shopify Orders panel in the sidebar listing two orders for the customer's email](https://mintcdn.com/chatbase/diqSheX4Phc7pTg7/user-guides/images/help-desk/shopify/shopify-orders-panel.png?fit=max\&auto=format\&n=diqSheX4Phc7pTg7\&q=85\&s=a05f07547ec2e647ea5f1a9e31269a9c)

The panel heading shows how many orders the customer has, e.g. `Shopify Orders (12)`. When Shopify can't give an exact number, you'll see an estimate instead, like `Shopify Orders (12+)`.

### Load more

Only the most recent orders load at first. Click **Load more** at the bottom of the list to fetch the next batch. This continues from where the list left off, so you won't see duplicates.

## Order details

Click any order card to open its full details. From here you can see everything needed to help with the order:

* **Line items**: each product with its image, quantity, and price
* **Pricing breakdown**: subtotal, shipping, tax, discounts, and the final total
* **Shipping address**: name, full address, and phone
* **Status badges** for fulfillment and payment (paid, pending, refunded, and so on)
* **Fulfillments & tracking**: fulfillment status plus tracking number, carrier, and a link to track the shipment
* **Quick links**: click **Open in Shopify** to open the order in your Shopify admin, or view the customer-facing **order status page**

Use **Back** to return to the order list.

## Order data in macros

You do not have to copy these details by hand. With a store connected, [macros](https://chatbase.co/docs/user-guides/chatbot/help-desk/macros.md) can pull the same order in as variables, so a shipping-update reply writes itself from `{{shopify.last_order.number}}`, `{{shopify.last_order.carrier}}`, and `{{shopify.last_order.tracking_url}}`. The variable picker gains two groups, **Shopify order** and **Shopify customer**, both reading the same most-recent order this panel shows.

## Resolve order tickets faster

Most store tickets are about one order. With the panel open next to the conversation, you can answer without asking the customer to repeat details or searching Shopify yourself. A few common cases:

**"Where is my order?"**

1. Open the ticket. The panel matches the customer's orders by their email, or by phone if there's no match.
2. Click the most recent order and check **Fulfillments & tracking** for the carrier, tracking number, and tracking link.
3. Reply with a shipping-update [macro](https://chatbase.co/docs/user-guides/chatbot/help-desk/macros.md#shopify-variables) that fills in `{{shopify.last_order.number}}`, `{{shopify.last_order.carrier}}`, and `{{shopify.last_order.tracking_url}}`, or share the customer-facing **order status page** from the quick links.

**"I ordered from a different email."** Type the email or phone number the customer used into the **lookup field** at the top of the panel. Click **Reset to ticket contact** when you're done to go back to the ticket contact's details.

**"Was I refunded?"** Open the order and check the payment status badge (for example, **refunded** or **pending**) and the **Pricing breakdown** for the total, discounts, and shipping.

**"The wrong item arrived" or "my order is damaged."** Open the order to see each line item with its image, quantity, and price, so you can confirm exactly what was shipped. Then click **Open in Shopify** to act on the order in your Shopify admin.

**"Can you change my shipping address?"** Check the **Shipping address** and the fulfillment status in the order details. No Shopify Action changes the shipping address on a placed order or cancels one, so your AI agent can send these requests to the Helpdesk through [Escalations](https://chatbase.co/docs/user-guides/chatbot/actions/escalate-to-human.md). Make the change in Shopify admin.

> [!TIP]
>
> Split shipments have more than one tracking number, but macros fill in only the first. Copy the second tracking number from **Fulfillments & tracking** in the panel.

## Frequently asked questions

> [accordion] Why don't I see the Shopify Orders panel on a ticket?
>
> The panel only appears when a Shopify store is connected to the AI agent the ticket belongs to. Connect your store with the [Shopify integration guide](https://chatbase.co/docs/user-guides/integrations/shopify.md).

> [accordion] Why does the panel show no orders for this customer?
>
> The panel searches by the ticket contact's email first, then their phone number. If the customer ordered with different details, search with the **lookup field** at the top of the panel.

> [accordion] What does a count like Shopify Orders (12+) mean?
>
> Shopify couldn't give an exact number, so the panel shows an estimate. Click **Load more** at the bottom of the list to fetch the next batch of orders.

> [accordion] Which order do Shopify variables in macros use?
>
> The most recent order Chatbase can match to the person who opened the ticket. It is the same order the panel reads. See [Shopify variables](https://chatbase.co/docs/user-guides/chatbot/help-desk/macros.md#shopify-variables).

> [accordion] How do I make changes to an order?
>
> The panel is read-only: you can't refund, cancel, or edit an order from it. Click **Open in Shopify** in the order details to open the order in your Shopify admin, and make the change there.

## Related

> [card] [Shopify Integration](https://chatbase.co/docs/user-guides/integrations/shopify.md)
>
> Connect your Shopify store to Chatbase to enable the orders panel and Shopify Actions.

> [card] [Macros](https://chatbase.co/docs/user-guides/chatbot/help-desk/macros.md)
>
> Saved replies that can fill in order number, status, and tracking automatically.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.