# Configuring the Shopify Search Orders tool for AI Agents > You can connect your Shopify storefront to an AI Agent using the Shopify Search Orders tool. Source: https://help.kustomer.com/en_us/shopify-search-orders-tool-ryIZtEyNxx Last updated: 2026-03-19T23:45:36.378Z You can connect your Shopify storefront to an AI Agent using the Shopify Search Orders tool. This allows the AI Agent to search Shopify directly and return real-time order details in response to the customer's inquiry. In this article, you’ll learn how to set up the Shopify Search Orders tool and get details on what fields are available to use in the search. **Who can access this feature?** **User types** Admins can access the Tools page. ### In this article * [Prerequisites](#prerequisites) * [Set up the tool](#setup) * [Available search fields](#available-search) * [Available output fields](#available-output) * [Set up an AI Agent](#setup-agent) * [FAQ](#faq) ### Prerequisites Before using this tool, you must [install the Shopify app](https://help.kustomer.com/shopify-integration-rkei5NSL) in Kustomer and set up your store(s). We also recommend having an understanding of [using tools in AI Agents](https://help.kustomer.com/understand-ai-agent-tools-ByB09BdAA). ### Set up the tool AI Agents use this tool to look up order information directly from Shopify. It can be used by both customer-facing agents ([AI Agents for Customers](https://help.kustomer.com/understand-ai-agents-SJWtPjAtC)) and internal agents using [Copilot](https://help.kustomer.com/en_us/use-copilot-SyU13vB1lg). The tool only reads from Shopify; it does not read from or write to Kustomer. 1. From the left navigation panel, click the ****Kustomer AI**** icon. 2. Click ****Tools**** to open the ****Manage Tools**** page.  3. Click **Add a Tool**.  4. Select **Shopify - Search orders** and from the **Store Name** drop-down menu, pick the store you want to connect. 5. **Enter a name for the tool.**  The tool’s name helps you identify it later and helps the AI Agent in understanding its function. By default, the tool is named “Get Shopify orders by order number.” **Note:** We recommend choosing a name that clearly reflects the store or use case so that you can easily identify the tool when creating an AI Agent. For example, “Shopify – US Store Order Lookup”. You can only use that name once. If you leave the default name and later try to create another tool with the same name, you won’t be able to. 6. **Optionally, edit the description.**  This helps the AI know when to use the tool. 7. **Choose your search fields.**  By default, the Order name/number is set. You can remove or replace this with a different field. **Note:** The AI Agent will **_always_** search by the customer's email address in addition to any other field you configure. If the customer does not have an email address on file in Kustomer, the tool will not return any orders. 8. **Select output fields.**  Choose what information the tool should return from Shopify when a match is found. The AI Agent can use the fields you select to help formulate a response or show directly to the end user. This [table shows a list](#available-output) of what is returned by default and what additional fields are available for you to add.  9. **Create a search query for each search field.** The tool won’t work unless each search field has a corresponding query. 10. **(Optional) Set the number of results to return** If more than one order matches the criteria, the tool will return all matching orders. To limit this, you can use the **Response Size** field to restrict the number of results returned. ### Available search fields Use the fields below to define what the AI Agent should look for when searching Shopify orders. For each field, the agent will take customer input and submit it directly as the search value, along with the customer's email, which is always included.  For example, if Order Number is the only search field and a customer enters "large brown bag", the agent will treat “brown, large, bag” as the order number and try to search for that. Field Description Display label Order Name/Number (default) The order name or number Order Number Created At When the order was created Created At Updated At When the order was last updated Updated At Processed At When the order was processed Processed At Financial Status The order’s financial status Financial Status Fulfillment Status The order’s fulfillment status Fulfillment Status Total Price The total price of the order Total Price Confirmation Number A randomly generated identifier that may be shown instead of the order number Confirmation Number Customer Name The customer’s name Customer Name ### Available output fields Below is a list of all the fields that the Shopify Search tool can return in its results, organized by category. Fields marked as (default) are included automatically. Result Field Description ID The order ID Name The order name/number Created At When the order was created Updated At When the order was last updated Processed At When the order was processed Financial Status The order’s financial status Fulfillment Status The order’s fulfillment status Total Price The total price of the order Subtotal Price The subtotal price of the order Total Tax The total tax of the order Customer Email The customer's email Customer Name The customer’s name Confirmation Number A randomly generated alpha-numeric identifier that may be shown to the customer instead of the sequential order name Order Metafields Any metafields set up on the order Customer Metafields Any metafields set up on the customer Shipping Address Field Description Address 1 (default) First line of the shipping address Address 2 (default) Second line of the shipping address City (default) City of the shipping address Province (default) Province or state of the shipping address Country (default) Country of the shipping address Zip (default) Postal or zip code of the shipping address Phone (default) Phone number at the shipping address First Name (default) First name of the recipient Last Name (default) Last name of the recipient Company (default) Company name at the shipping address Billing Address Field Description Address 1 (default) First line of the billing address Address 2 (default) Second line of the billing address City (default) City of the billing address Province (default) Province or state of the billing address Country (default) Country of the billing address Zip (default) Postal or zip code of the billing address Phone (default) Phone number at the billing address First Name (default) First name of the billing contact Last Name (default) Last name of the billing contact Company (default) Company name at the billing address Line Items Field Description ID The line item ID Title (default) The line item title Quantity (default) The quantity ordered (integer) Price (default) The unit price Total Price The total price for this line item SKU The SKU of the product Product Id The product ID Variant Id The variant ID Product Metafields Any metafields set up on the product Product Variant Metafields Any metafields set up on the product variant ### ### Set up an AI Agent You can use the Shopify Search Orders tool with both [Copilot](https://help.kustomer.com/set-up-copilot-B1p5rYV7ll) and [AI Agents for Customers](https://help.kustomer.com/understand-ai-agents-SJWtPjAtC).  When setting up an AI Agent for Copilot, adding additional guidance is optional. Below is an example prompt you can use, or customize, when configuring the Shopify Search Order tool with AI Agents for Customers. You are a customer service AI assistant for Kustomer, helping customers with their order inquiries and providing excellent support experiences. Tone and Approach: Always respond in a friendly, professional, and helpful manner. Make customers feel welcomed and ensure they receive clear, accurate information about their orders. Primary Objectives: - Provide accurate order information when customers inquire about their orders - Always display complete order details including fulfillment status - Format address information clearly and consistently - Offer helpful next steps when appropriate Conversation Flow: 1. Always greet the customer warmly 2. When a customer inquires about an order: - Politely ask them for their order number - Use the "INSERT\_TOOL\_NAME" tool to retrieve their order information - Provide all relevant order details in a clear, organized format - Always include the fulfillment status prominently Required Information Display: Always display the fulfillment status for any order inquiry. Always show the length of a snowboard if it is present. Always show the binding mount for a snowboard if it is present. Do not include any field with a missing or empty value. Address Formatting Standards: When displaying addresses, use this exact format: Shipping Address - Recipient: {firstName} {lastName} - Address Line 1: {address1} - Address Line 2: {address2} - City: {city} - Province/State: {province} - Country: {country} - Zip/Postal Code: {zip} ### FAQ **Q. Can I use the same tool for multiple stores?** No, each tool can only be used for one store.  **Q: If I change or delete a field in Shopify that’s being used in a tool, will it automatically update in Kustomer?** No. The tool does not sync with changes made in Shopify. If you delete or modify a field in your Shopify setup, the tool will stop working as expected. You’ll need to manually update the tool configuration in Kustomer to reflect those changes.