Shopify integration
Add the Paperchat chat widget to your Shopify store by pasting one line into your theme.
This guide walks you through adding the Paperchat chat widget to a Shopify store. The whole thing takes a few minutes and does not require any code beyond pasting a single tag into your theme.
Paperchat works on any Shopify theme by injecting a small script into the storefront. Once installed, the chat bubble appears on every page, including product pages, collections, the cart, and checkout pages where custom scripts are allowed.
What you will need
- A published Paperchat chatbot. If you do not have one yet, follow the How to use Paperchat guide first.
- Your chatbot ID, which you can find in your dashboard under your chatbot's Embed tab.
- Owner or Staff access to your Shopify admin with permission to edit themes.
Add your store domain to the allowed list
Before installing the script, make sure your storefront domain is listed under Allowed Domains in your chatbot settings. Add both the live domain (for example yourstore.com) and your Shopify subdomain (yourstore.myshopify.com) if you use one. The widget will silently refuse to load on domains that are not on the list.
Install the widget
Open your theme code editor
In your Shopify admin, go to Online Store > Themes, find your live theme, click Actions, and choose Edit code.
Open theme.liquid
In the file tree on the left, expand the Layout folder and open theme.liquid. This file wraps every page on your storefront, which makes it the right place to install a site-wide script.
Paste the embed snippet
Scroll to the bottom of the file. Just before the closing </body> tag, paste the snippet below. Replace YOUR_CHATBOT_ID with the ID from your dashboard.
<script async src="https://paperchat.co/widgets/livechat/v1.js" data-paperchat-id="YOUR_CHATBOT_ID"></script>Save
Click Save in the top right of the code editor. Shopify applies the change immediately, no publishing step required.
Verify the widget is live
Open your storefront in a new tab. The chat bubble should appear in the bottom right corner within a couple of seconds. If you do not see it, open the browser console and look for messages from the Paperchat script. The two most common causes are a typo in the chatbot ID and a missing entry in your Allowed Domains list.
Hiding the widget on specific pages
If you would rather not show the chat bubble on, for example, the checkout success page or a campaign landing page, wrap the snippet in a Liquid conditional. The example below skips the widget on any page whose handle is thank-you:
{% unless page.handle == 'thank-you' %}
<script async src="https://paperchat.co/widgets/livechat/v1.js" data-paperchat-id="YOUR_CHATBOT_ID"></script>
{% endunless %}You can also wrap the snippet inside a single template, such as product.liquid, to limit the widget to product pages only.
Troubleshooting
The widget does not appear. Check that the snippet sits inside theme.liquid and not inside a section or block that only renders on specific templates. Confirm your chatbot ID matches the one in the dashboard exactly.
The widget appears but does not respond. Open your chatbot's Sources tab and make sure at least one source has finished training. A chatbot with no trained data will return a default fallback message for everything.
The widget loads twice. You likely pasted the script in both theme.liquid and an app block. Remove one of them.
For anything else, write to support@paperchat.co with a link to your store and we will take a look.