Install on Shopify
Install Handychat from Shopify, turn on the app embed in your theme editor and switch your agent live.
Install Handychat on your Shopify store, enable the chat in your theme, and switch your agent on. It takes a few minutes.
Before you start
- You need a Shopify store and a staff account that can install apps and edit your theme.
- Handychat asks for access to view your products, orders, store policies and inventory, and to change orders, order edits, draft orders and discounts. The agent only changes an order after the shopper verifies and confirms, and refunds always wait for your approval.
Install the app
Add Handychat to your store
Open the Handychat listing in the Shopify App Store and install it. Review the permissions Shopify shows you and approve them.
Can't find the listing yet?
Create an account at app.handychat.ai/sign-up, open Install in the dashboard and use Connect your Shopify store. Enter your store address (for example my-store.myshopify.com) and click Connect Shopify.
Create your account (if asked)
If Handychat shows Create your Handychat account to continue, click Create account. It opens in a new tab so you can sign in anywhere later, invite teammates and manage your agents. When you finish, go back to the Shopify tab.
Wait for your catalog to sync
Handychat starts syncing your product catalog as soon as the install completes. Product cards, add to cart and order tracking turn on when the sync finishes.
Choose a plan
Open Billing and pick a plan. Shopify shows its confirmation page; approve it to start your 7-day free trial. Your charges appear on your Shopify invoice. Until you choose a plan, AI replies stay Paused.
Turn on the app embed
Open Install in the Handychat dashboard. In the Enable the app embed card, click Open theme editor. Shopify opens your theme editor on App embeds with Handychat chat widget ready to switch on. Make sure it is on, then click Save.
Switch your agent to Live
Open Agents and turn on the Live switch (it reads Paused when off). The chat bubble stays hidden on your storefront until your agent is live.
Check it works
Open your storefront in a new tab. The chat bubble should appear. Back on the Install page, the card changes from Waiting for your widget to Widget detected and the badge shows Installed. The page checks every 5 seconds while it is open.
App embed settings
In the theme editor, Handychat chat widget has these settings:
| Setting | Options |
|---|---|
| Widget position | Use dashboard setting, Bottom left, Bottom right |
| Accent color | Leave blank to use the color set in the Handychat dashboard |
| Launcher button label | Leave blank for the automatic translation for the shopper's language |
| Widget language | Auto (detect from storefront), English, Arabic |
Anything you set here wins over the Widget page in the dashboard. Leave a setting blank (or on Use dashboard setting) to manage it from the dashboard instead. See Web chat and design editor.
Good to know
Bubble still missing?
The most common causes are the app embed being off, the theme change not saved, or the agent still Paused. Follow Chat bubble not showing.
- Two more theme blocks. You can also add Handychat AI search and Handychat product FAQs from the theme editor. See AI search bar and Product page FAQs.
- Uninstalling the app switches your store off in Handychat. Reinstalling reactivates it and re-runs the setup.
- Billing for Shopify installs goes through Shopify, not Stripe. See Plans and billing.