# Shopify

> Add the Quickchat AI shopping assistant to your Shopify store. Install via the Shopify App Marketplace or embed the widget manually.

In this guide, we'll show how to add Quickchat AI Widget to your Shopify store.

## Optional example checks

- [Check a Widget snippet][public-lab-widget-snippet-webmcp]. Check pasted code against the supplied Scenario ID. This does not fetch your website.

- [Compare deployment methods][public-lab-deployment-fit-webmcp]. Check your declared channels, website access and required features against Quickchat AI setup options. This does not inspect your website or account.

In a compatible browser, these checks are also available as site tools. The links open the standard forms.

## What you’ll need

- A Shopify store
- The [**Shopping Agent by Quickchat AI**](https://apps.shopify.com/quickchat-ai) app installed from the Shopify App Marketplace (if you don't want to install it and you'd rather connect it manually, [scroll down to the second part of the tutorial](#how-to-manually-add-a-widget-script))
- User permission to edit themes

_Time to complete: \~2 minutes_

---

## What are Shopping AI Agents?

In this short video you will learn the basics: how to turn your Shopify store into a Shopping AI Agent using Quickchat AI and Shopify MCP.

[Watch on YouTube](https://www.youtube.com/watch?v=NPZEg4OVSRE)

## Step 1: Open your Theme Editor

There are two ways to do it:

### Option A (recommended): from Quickchat AI App

From the [Quickchat AI App](https://app.quickchat.ai) home/welcome page, click **Enable Widget in Shopify Theme Editor**.

This deep-links to your store’s Shopify Theme Editor directly in the App embeds context, where the app embed can be enabled.

:::note
**Enable Widget in Shopify Theme Editor** only appears for stores already connected to Quickchat AI via the Shopify app (OAuth).
:::

### Option B: from Shopify Admin

Go to [Shopify Admin](https://admin.shopify.com/) → **Online Store → Themes** → on your current theme click **Customize**.

![Screenshot: Themes page with the **Customize** button highlighted](https://quickchat.ai/docs/_astro/1-Customize.kXpfCtQj.png)

---

## Step 2: Enable the app embed

Inside the Theme Editor, open the left sidebar and go to **App embeds**.

![Screenshot: App embeds panel](https://quickchat.ai/docs/_astro/2-App_embeds.DKD14wCr.png)

Find **Quickchat AI Widget** and toggle it **on**.

![Screenshot: Enable Quickchat AI in the Theme Editor](https://quickchat.ai/docs/_astro/3-Enable_Quickchat_AI.D1FqUroH.png)

Then click **Save** (top-right).

![Screenshot: Save button in the Theme Editor](https://quickchat.ai/docs/_astro/4-Save_changes.DSUh2_7g.png)

---

## Step 3: Confirm on your storefront

Open your storefront (preview or live site) and look for the Quickchat AI chat bubble in the bottom-right corner of the page.

That’s it!

**Quickchat AI Agent is live on Shopify Store 🎉**

---

## How to manually add a widget script

If you don't want to install our Shopify App because you already have an AI Agent built in Quickchat AI App, you can add a simple script that displays it on your Shopify Store.

:::note[Have you connected your AI to Shopify data already?]

To connect your AI Agent to your Shopify store's data such as product catalog and cart, please do the following:

1. Paste your store link on this page: [quickchat.ai/shopify](https://quickchat.ai/shopify)
2. Claim it, customize, and embed on your site
   :::

### 1. Open the theme code editor

1. Go to your [Shopify Admin Panel](https://admin.shopify.com/).
2. In the left menu, click **Online Store → Themes**.

![Edit theme code](https://quickchat.ai/docs/_astro/step1.D2A2jU3m.webp)

3. In the “Current theme” section, click the **three dots (⋯)** next to the **Customize** button.
4. Select **Edit code** from the dropdown.

![Open theme.liquid](https://quickchat.ai/docs/_astro/step2.DTegQpNx.webp)

### 2. Find `theme.liquid`

1. In the code editor, expand the **layout** folder on the left.
2. Click on `theme.liquid` to open the main layout file of your theme.

![Open theme.liquid](https://quickchat.ai/docs/_astro/step3.f8kBmP3p.webp)

### 3. Paste the script

1. In the [Quickchat App](https://app.quickchat.ai), navigate to **Your Website → Install**.
2. Copy the generated script.
3. Paste it just **above the `</body>` tag** at the bottom of the `theme.liquid` file.

```html
<script>
  (function(e,a,d,i,c,t=a.createElement(d)){e[c]=e[c]||function(){(e[c].q=e[c].q||[]).push(arguments)},t.src=i,t.async=1,a.body.insertAdjacentElement("beforeend",t)})(window,document,"script","https://bubble.quickchat.ai/chat.js","_quickchat");
  _quickchat("init", "YOUR_AI_ID_HERE");
</script>
```

---

## Security indicators on the Shopify App Marketplace listing

The Shopify App Marketplace shows which optional security protections each app has adopted. On the [**Shopping Agent by Quickchat AI**](https://apps.shopify.com/quickchat-ai) listing you may see that two of them aren't in use:

- **Expiring access tokens**: when you install the app, Shopify gives it a standard access token for your store. That token stays valid until you uninstall the app. The app doesn't use Shopify's newer tokens that expire and renew automatically.
- **Enforced IP restrictions**: the app's access to your store isn't limited to a fixed list of server IP addresses.

These indicators don't change how the app works, and you don't need to do anything about them. The app can only use the permissions you approved during installation, and uninstalling it revokes its access to your store.

If you have other questions about how the app accesses your store, email [support@quickchat.ai](mailto:support@quickchat.ai).

[public-lab-widget-snippet-webmcp]: https://app.quickchat.ai/v1/api_core/public-question/quickchat/tools/widget-snippet/lab/webmcp/?placement=docs-shopify-widget-snippet-webmcp-v1

[public-lab-deployment-fit-webmcp]: https://app.quickchat.ai/v1/api_core/public-question/quickchat/tools/deployment-fit/lab/webmcp/?placement=docs-shopify-deployment-fit-webmcp-v1
