Connect a Shopify store

Every Shopify client gets its own ShopAssist app, which ShopAssist creates for that store. You add the client, ShopAssist creates the app and emails you an install link, and the store owner installs it.

What the app provides

Component	Description	Placement
Chat widget	Floating chat button and modal on every storefront page	The Shop Assist app embed in the theme editor
Ask ShopAssist	Question pills on the product page	The Ask ShopAssist block in the theme editor
Compare	Compare button on the product page	The Compare button (PDP) block in the theme editor
Order reporting	Sales that followed a conversation, in the dashboard	Automatic, after install

1. Add the client

In the partner portal, select Add client, choose Shopify, and enter the store's .myshopify.com address, for example acme-store.myshopify.com. A custom domain such as acme.com is refused, because Shopify identifies the store by its .myshopify.com address.

The store owner can find that address in the Shopify admin under Settings → Domains.

The card reads created, with the note that ShopAssist is creating the app.

2. Wait for the install link

ShopAssist creates the store's app and emails everyone in your agency when it is ready. The email contains the install link, and the client card shows a Copy install link button.

3. Send the link to the store owner

The store owner opens the link while signed in to their Shopify admin, reviews the permissions and approves the install. The link does not expire until the store is connected, so it can wait in their inbox.

Once they approve, the card reads Connected. The store is still off for shoppers.

In the Shopify admin, open Online Store → Themes → Customize.

Open App embeds and turn on Shop Assist. Save.
Optional: add the Ask ShopAssist or Compare button (PDP) block to the product page template. See Enhance ShopAssist - Shopify.

Nothing appears to shoppers until the shop is live, so this can be done before or after the assistant is built.

5. Build the assistant and go live

Continue with Build and ship the assistant. Installing does not take the store live. Go live in the portal does, after the assistant is published.

Troubleshooting

Symptom	Cause	Resolution
"Enter the store's .myshopify.com address"	A custom domain was entered	Add the client again with the `.myshopify.com` address
No Copy install link button	ShopAssist has not created the app yet	Wait for the email, or contact support
The install link says the store is already installed	The store is connected	Nothing to do. The card reads Connected
The card reads disconnected	The app was uninstalled from the store	Send the install link again
Connected and live, but no widget	The Shop Assist app embed is off	Turn it on in the theme editor (step 4)

For anything else, email support@getshopassist.com with the shop domain and the step reached.