The Shopify app handles the OAuth dance and gives you a theme-editor app block you drop into your theme. No theme code edits required.
Shopify supports two install modes for embedded apps in 2026: theme app blocks (the modern path on Online Store 2.0 themes — what we recommend) and script-tag injection (the legacy path, still works on older themes). The FoxChat Shopify app supports both. This guide covers the modern theme-app-block path; if your theme is pre-Online-Store-2.0, see the troubleshooting section at the bottom.
From your Shopify admin, click Apps in the sidebar, then Shopify App Store. Search for FoxChat. Click the official FoxChat listing (published by FoxChat, with our logo). Click Install on the listing page.
Shopify shows a permissions modal listing what the app needs access to. The minimum scope set is:
read_themes — to detect which theme is active and offer the right install instructions.read_products, read_collections, read_pages, read_articles — so Foxy can answer "do you have a size 9 in this style" or "what's your return policy" by reading your store's actual data.read_orders (optional) — lets the AI agent answer "where's my order" by looking up real order status. You can decline this scope and the app still works for everything else.Click Install app. Shopify completes the OAuth round trip and lands you on the FoxChat embedded app dashboard.
The embedded app dashboard shows a Add to theme button. Click it. Shopify opens the theme editor in a new tab with the FoxChat app block selected. The block has a single setting: which FoxChat site this store maps to (auto-filled with the site the app created on first install).
Click Save in the theme editor. The bubble is now live on your storefront.
Open your storefront in a new browser tab. The Foxy bubble should appear in the bottom-right corner of every page within a couple of seconds. Click it; the chat panel opens. Try asking about a product you have in stock — Foxy reads your product catalog and answers from real data.
If the bubble does not appear:
/checkouts/ URLs by default), but if it's not appearing on regular pages either, this setting may be the cause.If you already have a FoxChat account, click Connect existing account in the embedded app dashboard and OAuth-link this Shopify store to it. The Shopify-installed site will appear alongside any other FoxChat sites you have. If you don't have a FoxChat account yet, the install flow auto-creates a trial account using the email on your Shopify admin profile.
If you approved the read_orders scope, Foxy can answer "where's my order" questions by looking up the visitor's most recent order via the email they identify with. Enable this from the embedded app's Order lookup settings tab. Visitors then see Foxy say "I can pull up your most recent order — what email did you check out with?" when they ask order-status questions.
If you declined the read_orders scope, that's fine — Foxy answers product, policy, and general questions and routes order-status questions to your support email.
From Shopify admin: Apps → find FoxChat → Uninstall. Shopify revokes the OAuth tokens and stops loading the widget. Your FoxChat conversation history remains in your account.
The first time the FoxChat app installs, it kicks off a one-time catalog import. Foxy reads your products, collections, pages, and blog articles via the Shopify Admin API. The import takes a few minutes for small stores and up to half an hour for stores with thousands of products. You can keep using your storefront during the import; the bubble appears immediately and answers what it knows so far.
After the initial import, the app keeps the catalog in sync via Shopify webhooks. When you publish a new product, edit a description, or update a policy page, Foxy's knowledge updates within seconds. You don't need to manually refresh anything.
If you ever want to manually re-sync — useful after a bulk catalog migration — the embedded app dashboard has a Re-sync catalog button. It re-fetches everything from scratch.
script-tag-typed content to your theme automatically using the legacy ScriptTag API. Same end result; the only difference is you don't see the app block in the theme editor sidebar.
Install the Shopify app, click Add to theme, save. Your storefront is FoxChat-enabled.
Start free trial