Skip to main content

Install ShopGuide on Shopify

Getting ShopGuide installed and doing its first useful thing takes a few minutes. Here's the whole path.

Before you start​

You'll need a Shopify store on any plan, admin access to it, and a basic sense of your way around the Shopify admin panel.

Installing it​

Visit ShopGuide on the Shopify App Store, click "Add app" on the listing, review the permissions it's asking for, and click "Install app."

The onboarding that follows​

Shopify drops you straight into the ShopGuide admin app afterward, and the first thing you'll see is a short flow: a quick question about how you heard about ShopGuide, then a spot to leave a name, email, and phone number so the team can reach you if something needs attention. After that you land on the Pricing page, which shows you are on the Free plan (nothing to pay). Click Set up now to open the Setup Guide on Home. Shopify partner development stores go straight to Home.

The Setup Guide​

The Setup Guide on Home is the install checklist. It opens with "Welcome to your <shop> ShopGuide! Let's get you started" and has three steps:

  • 1. Fill Out Essential Settings: your launch message and suggestion buttons (button: Open Essential Settings).
  • 2. Customize your widget: the look of the chat (button: Open Customize).
  • 3. Place Widget in Theme Editor: add the chat to your theme (button: Open Theme Editor, or Go to Themes).

Each button opens in a new tab and ticks its step; ticks are remembered per browser. Close the guide with Skip for now or Go Live!, and reopen it any time with the Setup Guide button on Home. It does not open by itself for stores that already had chats in the last 30 days.

Making sure it actually worked​

Open Analytics and check that data is starting to populate; Home shows key stats too. Confirm ShopGuide shows up in your Shopify admin sidebar. If Home shows an Essential Settings Missing banner, click Complete Essential Settings to set your shop content language and a support contact (a support email or a valid Slack webhook). And add the ShopGuide Chat section to a theme page — see the Quick start guide — to confirm the widget actually loads on your storefront.

Once you're set up​

If something goes wrong​

App not showing up in your admin? Refresh the browser and check the Apps section, and confirm you actually have admin permissions on the store. Installation failing outright? Check your connection, or try a different browser — some ad blockers and privacy extensions interfere with the OAuth flow.

Need a hand beyond that? See Support & escalation for how to reach the team.