Skip to content
AskVault Docs
Try Free →

How to add an AI chatbot to your Shopify store

Written by , Founder, AskVault · Reviewed by Aashiq
Last updated: · 4 min read

What the bot can do for a Shopify store

A Shopify storefront gets four obvious wins from a knowledge-grounded AI chatbot:

  1. Product questions answered from your product descriptions, FAQ, and sizing guides.
  2. Shipping and returns answered from your policies pages.
  3. Order status answered automatically from the Shopify Orders API ("where is my order?", "is order #1234 shipped?").
  4. Cart recovery when a visitor hesitates on a product page or starts adding items but doesn't check out.

The chat widget handles the first two out of the box from the moment you crawl your storefront. The order-status and cart-recovery flows need the Shopify integration enabled, which we cover in section 3.

Free tier covers 100 queries per month. For a working store, you usually want the Starter or Growth plan: ₹2,499 or ₹4,999 per month with 3,000 or 15,000 queries respectively.

Step 1: install the widget in theme.liquid

This takes 60 seconds and works on every Shopify theme (Dawn, Debut, Sense, Studio, Refresh, and every third-party theme we've tested).

  1. Sign in to AskVault. In Deploy > Widget, copy the workspace token from the generated script tag.

  2. In your Shopify admin, open Online Store > Themes, click Customize on your current theme, then Edit code from the three-dot menu.

  3. In the file tree, open Layout > theme.liquid.

  4. Find the closing </body> tag near the bottom (Ctrl+F is your friend). Paste this snippet on the line directly above it:

    <script
      async
      defer
      src="https://api.askvault.co/widget.js"
      data-workspace-token="wt_yourtoken_here"
    ></script>

  5. Click Save.

Open your storefront in an incognito tab. The chat launcher appears bottom-right within about 200 ms. If you're testing in Shopify's theme preview, make sure you're viewing the published theme, not a draft.

Step 2: train the bot on your store content

By default the AskVault onboarding wizard crawls your homepage and follows internal links. For a Shopify store you usually want it to specifically index:

  • Product pages (Shopify automatically generates these at /products/...)
  • Collection pages (/collections/...)
  • FAQ, shipping, returns, and policy pages
  • Your blog if you publish one

In AskVault, open Knowledge > Add Source > Website crawl, paste your storefront root URL, and enable Use sitemap if your store publishes one (most Shopify stores do at /sitemap.xml). Crawling 500 product pages takes about 8 to 12 minutes. Indexing 50 pages takes about 90 seconds.

Once indexing completes the bot can answer questions like:

  • "Do these jeans run small?"
  • "What's your return policy on sale items?"
  • "Do you ship to Canada and how long does it take?"
  • "Is this dress available in size 12?"

All grounded in your real product descriptions and policy pages, with clickable source links so visitors can verify.

Step 3: connect Shopify Orders for live order-status answers

This is the big one. With the Shopify integration enabled, the bot can answer "where is my order?" without you writing any logic.

  1. In AskVault, open AI Agents > Skills.
  2. Find Order Status (WISMO) and click Enable.
  3. Click Connect Shopify to start the OAuth flow.
  4. You'll be redirected to your Shopify admin to authorize the integration. Required scopes: read_orders, read_customers, read_shipping.
  5. Approve. You're redirected back to AskVault.

Now when a customer asks "where is my order?" the bot responds something like:

Sure! To look up your order I need either the order number or the email address you used at checkout. Could you share one of those?

Once the customer provides an order ID or email, the bot calls the Shopify Orders API in real time, pulls the live status, and replies with the tracking link, carrier, and estimated delivery date. It works for any order placed within the last 12 months by default.

The skill is read-only. It can look up orders but never modify them, refund them, or change shipping addresses. For those actions the bot offers to escalate to a human via the escalation skill.

This is on the Growth plan and higher. Growth+

Step 4: enable cart recovery (Growth+ feature)

A common Shopify pattern: a visitor adds items to cart, doesn't check out, leaves the site. The AskVault widget can detect cart hesitation (visitor sits on the cart page for more than 30 seconds, or starts the checkout flow but doesn't complete it) and proactively offer help.

In AI Agents > Skills, enable Cart Recovery. The bot now sends a non-intrusive nudge after detected hesitation:

Looks like you're checking out a denim jacket. Anything I can help with? Sizing, shipping, or discount questions?

You can customize the trigger conditions and the message text under the skill's settings. Growth+

Customize the widget for your storefront

In Widget Studio you can match the widget to your store's brand:

  • Primary color. Hex picker. Pair it with your store's accent color from the Shopify theme settings.
  • Launcher position. Bottom-right (default) or bottom-left. Bottom-left tends to convert better for stores with a right-aligned cart icon, since the launcher doesn't compete visually.
  • Welcome message. The first thing visitors see when they open the chat. Something like "Hi, I'm the store assistant. I can answer questions about products, shipping, returns, or your order."
  • Logo. Replaces the AskVault "AI" icon. Upload your store logo (SVG or 64x64 PNG).
  • Position offset. Useful if your theme has a sticky cart bar or banner that overlaps the default launcher position.

All changes preview live before publish. Publishing pushes the new config to your storefront within 60 seconds. No theme republish needed.

Performance and Core Web Vitals

The widget loads with async + defer. Bundle size: 12 KB gzipped. Lighthouse Performance score doesn't move when you add or remove the widget. Largest Contentful Paint stays clean because the launcher button is positioned with fixed CSS and doesn't enter the layout flow.

Shopify storefronts tend to have heavy themes already. The widget's bundle is dwarfed by typical Shopify theme JavaScript (300 KB to 1.2 MB), so don't worry about it pushing your Lighthouse score lower.

Hide the widget on checkout

Shopify's checkout pages run on /checkouts/... and are served from a different theme (Shopify's checkout theme, not your storefront theme). The widget you installed in theme.liquid won't appear on checkout pages by default. That's usually what you want.

If you DO want the widget on checkout, you need Shopify Plus + a custom checkout extension. Most stores skip this because the checkout flow should stay distraction-free for conversion.

Troubleshooting

The launcher doesn't appear after I save. Open the storefront in an incognito window. Shopify aggressively caches the theme for admin users. Or wait about 60 seconds for the theme cache to expire.

Bot answers product questions wrong. Check Knowledge Hub in AskVault. If product pages haven't been indexed, the bot is answering from outdated content. Re-crawl with Use sitemap enabled.

Order-status lookups fail with "I couldn't find that order". Verify the customer is using the same email as their order, or the exact order number including the # prefix. Shopify is case-insensitive for emails but exact-match for order IDs.

Multiple chat widgets on the page. You have another chat app installed (Shopify Inbox, Tidio, Gorgias). Uninstall the other plugin or move the AskVault widget to bottom-left in Widget Studio.

FAQ

Do I need Shopify Plus?

No. The widget and all skills work on every Shopify plan including Basic Shopify (₹1,994/mo in India). Shopify Plus is only required if you want the widget rendered inside the checkout flow itself.

Can the bot apply discount codes?

The bot can offer codes you've set up in advance, but it can't create new discount codes on the fly. That's a Shopify-side limitation. For tighter discount-negotiation flows, look at the discount_negotiator skill which is Business+ tier. Business+

Does it work with Shopify multi-currency?

Yes. The bot quotes prices in the same currency the visitor's storefront is configured for. If a Canadian visitor lands on your CA-priced storefront, the bot quotes prices in CAD.

How does it handle out-of-stock products?

The bot pulls inventory state from your Shopify product feed at crawl time. For real-time inventory, enable the Shopify integration (Step 3) and the bot will check live stock via the Products API before answering. Stock-related questions then get accurate, current answers.

Will it slow down my conversion rate?

In our customer data, stores that add an AI chatbot see a 2 to 7 percentage point lift in conversion, primarily because pre-purchase questions get answered immediately instead of bouncing. We don't have public case studies yet because we're early-stage; reach out to sales@askvault.co if you want one of our beta-customer references.

Was this page helpful?