Skip to main content
The Chatbase Shopify integration connects your Shopify store to a Chatbase AI agent, so the AI agent can answer shoppers with your live catalog, cart, and order data. It’s for Shopify merchants who want one assistant that helps shoppers before they buy (finding products, filling the cart, checking out) and after (tracking orders, returns and exchanges, account updates). Installing the Chatbase app adds the Chat Bubble to your storefront automatically, and many Shopify Actions also work on channels such as WhatsApp, Instagram, Messenger, and Phone.

What you can do:

Give shoppers a single place to find a product, add it to the cart, check out, and ask where their order is, without leaving the chat.
You do not need to add any embed code manually. Once you install the Chatbase Shopify app, whether from Chatbase or the Shopify App Store, the Chat Bubble is automatically added to your store. You do not need to copy or paste any embed script into your theme code.

What your AI agent can do for your store

You choose what the AI agent can do by turning on Shopify Actions. Before the purchase After the purchase No Shopify Action cancels an order or changes the shipping address on a placed order. Send those requests to your team with Escalations. See Limitations.

Example: from product question to order tracking

  1. A shopper on your storefront opens the Chat Bubble and asks, “Do you have a waterproof jacket under $100?” The AI agent uses Retrieve and display products and shows matching jackets with Add to cart buttons.
  2. The shopper says, “Add the black one in medium.” The AI agent uses Update cart, then asks whether they want to add more or place the order.
  3. The shopper says, “Check out.” The AI agent uses Create order and replies with a secure Shopify checkout link.
  4. A few days later, the same shopper asks, “Where is my order?” The AI agent uses Retrieve and display orders. If the shopper is signed in, the order is found automatically. If they’re a guest, the AI agent asks for their checkout email (or phone number) and order number first. Shipped orders show as On its way.

Before you start

Integration methods

You can connect your Shopify store to Chatbase in two ways:
We recommend connecting via Chatbase for full access to all features and add-ons.
This method gives you access to all Chatbase features and add-ons, and you can start a 7-day free trial.
1

Find the Shopify integration

  1. Go to your Chatbase dashboard and select the AI agent you want to connect to Shopify.
  2. Open the Shopify connection flow in either of these ways. Both lead to the same store connection step below:
    • Click Channels from the sidebar, then click Setup on the Shopify card.
    • Or, click Integrations from the sidebar, then click Connect on the Shopify card.
2

Connect your store

  1. Enter your Shopify store name, which is the subdomain of your myshopify.com URL. For example, if your store is at mystore.myshopify.com, enter mystore. You can find it in your Shopify admin under Settings > Domains.
    The Shopify Integration window asking for your store name before the myshopify.com domain
  2. Click Submit to start the authorization process.
  3. Shopify will ask you to authorize Chatbase. Review the requested permissions and click Install.
  4. Once authorized, you’ll be redirected back to Chatbase with a confirmation message.
3

Manage your integration

On the Channels page, click Manage on the Shopify card.
The Manage button on the Shopify card
Make sure the toggle at the top right of the page is on. Then choose the theme your website is currently using, open your Shopify theme editor, and make sure the Chatbase app toggle is on.
The Shopify manage page with the toggle switched on at the top right
Choosing the live theme and opening the Shopify theme editor

Method 2: Connect via Shopify Marketplace

Choose this method if you prefer to manage billing through Shopify. This option has limited add-ons, allows only a single AI agent, and does not include the 7-day free trial.
1

Install the Chatbase app

  1. Go to the Chatbase app listing on the Shopify App Store.
  2. Click Install.
  3. Review the permissions Chatbase requires and click Install to approve.
The Shopify Install app dialog listing the permissions Chatbase needs
2

Complete setup

  1. After installation, you’ll be redirected to the Chatbase onboarding process to finish setting up your account.
  2. Follow the prompts to configure your AI agent.
3

Manage your integration

On the Channels page, click Manage on the Shopify card.Make sure the toggle at the top right of the page is on. Then choose the theme your website is currently using, open your Shopify theme editor, and make sure the Chatbase app toggle is on.
Accounts created through the Shopify Marketplace are limited to a single AI agent and do not include the 7-day Chatbase free trial. For multiple AI agents, additional add-ons, or the free trial, use Method 1 instead.
Open your storefront and confirm the Chat Bubble appears and your AI agent responds. If you can’t see the AI agent on your website, check the toggle in either of these places:
  • Click Channels from the sidebar and open Chat Bubble. In the Overview tab, make sure the Visibility toggle is switched on.
  • Or, on the Channels page, click Manage on the Shopify card and make sure the toggle at the top right of the page is on.
The Visibility toggle in the Chat Bubble Overview tab

Setup checklist

Work through these steps in order to go from a connected store to an AI agent that’s ready for shoppers:
  1. Connect your store with Method 1 or Method 2, and confirm the Chat Bubble appears on your storefront.
  2. Train on your store policies, not your product pages. See What to train your AI agent on.
  3. Create the Retrieve and display products Action and sync your catalog. See Sync your products.
  4. Turn on your first Actions. See Which Actions to turn on first.
  5. Test from your live storefront. Cart updates don’t work in the Playground, so test cart, checkout, and account flows from the Chat Bubble on your store. See Limitations.
  6. Publish, then add Tests. Tests run against your published AI agent, not your draft. Write a test for the requests you get most, such as “a shopper who placed order #1042 five days ago and wants to know where it is”, with Retrieve and display orders as the expected Action.

What to train your AI agent on

Shopify Actions give the AI agent your live products, carts, and orders. Data Sources give it everything else a shopper asks about: your policies and how your store works. Train on:
  • Shipping pages: where you ship, delivery times, and costs
  • Returns and exchanges policy: the window, condition rules, and who pays return shipping
  • FAQ and help center pages, size guides, care instructions, and contact details
  • Answers you want worded exactly, added as Q&A sources
Don’t train on product or collection pages. With the Retrieve and display products Action enabled, your catalog syncs directly from Shopify and stays up to date. Scraped product and collection pages go stale and compete with the synced data, which can lead to outdated prices or out-of-stock items in answers. If your website is a training source, exclude the /products and /collections folders. See Sync your products.
To add your store’s website as a source, add your sitemap at /sitemap.xml instead of crawling the whole store. This uses less of your size limit and avoids duplicate product and collection pages. See Website.
When you update a Data Source, such as your returns policy, it shows Syncing while it trains and Synced once your AI agent can use it. This usually takes a few minutes, depending on the amount of content.

Which Actions to turn on first

Start with the Actions that answer the most common store questions, then add the ones that change orders once you’ve decided your rules.
  1. Product discovery and cart: Retrieve and display products, Update cart, and Get cart.
  2. Order tracking: Retrieve and display orders, so “where is my order?” is answered without a ticket. It works for signed-in shoppers and for guests who verify the order.
  3. Returns and exchanges, once your rules are set: the same-order return completes on its own inside the Return window (days) you set, while the new-order exchange always waits for approval in the Helpdesk. To control when either one runs, call it from a Procedure. See Keeping high-stakes Actions on rails.
  4. Checkout: Create order, so shoppers can place the order in the chat. Turn on Update cart whenever you use Create order with Use the cart, or the cart stays empty and there’s nothing to order.
Your plan sets how many Actions an AI agent can have. See the pricing page for the limit on each plan. On Enterprise, the limit is customizable. The five Actions in steps 1, 2, and 4 cover product discovery, checkout, and order tracking.

Limitations

  • One AI agent per store. Even on the Chatbase method, where you can have multiple AI agents, only a single AI agent connects to the Shopify store.
  • Marketplace accounts are capped at one AI agent, have access to auto recharge credits only, and do not include the 7-day free trial.

Frequently asked questions

No. Installing the Chatbase Shopify app, from Chatbase or the Shopify App Store, adds the Chat Bubble to your store automatically. If you don’t see it, check that the toggle on the Shopify Manage page is on and that the Chatbase app toggle is on in your Shopify theme editor.
No. The product sync already covers your catalog. Train on your shipping, returns, and FAQ pages instead. See What to train your AI agent on.
Yes. Signed-in shoppers get their orders looked up automatically. Guests verify the order with their checkout email and order number, or their phone number and order number. If Search by confirmation number is on, guests can give the order’s confirmation number instead of the order number. See Signed-in and guest customers.
No. No Shopify Action cancels an order or changes the shipping address on a placed order. Route those requests to your team with Escalations.
Yes. A reply that triggers an Action costs twice the model’s usual message credits. See Credit usage.

Next steps

Once your store is connected, enable the Actions that let your AI agent help customers with product search, order lookups, cart management, and more.
The first half of the Shopify Actions list: Retrieve and display products, Update cart, Create order, Create exchange (new order), and Create return or exchange (same order)
The second half of the Shopify Actions list: Get cart, Retrieve and display orders, Update customer profile, Update billing address, Check account, and Tag an order
With the Retrieve and display products Action enabled, you don’t need to train your AI agent on your product or collection pages. The Action syncs your catalog directly from Shopify, so exclude /products and /collections from your website training source. See Sync your products.

Shopify Actions

Configure and use Shopify Actions to help customers browse products, manage their cart, place orders, return and exchange items, track deliveries, and update their account information.