Skip to main content

Shopify App Installation Guide

This guide walks you through installing the Witzo app, connecting your Shopify store, configuring your AI assistant, and enabling the storefront widget.

Installation Overview​

The setup consists of three phases:

  1. Install the Witzo app from Shopify
  2. Configure your Witzo account
  3. Enable the Witzo widget in your Shopify theme

Shopify Dashboard​

In this phase, you install the Witzo app and authorize it to access your Shopify store.

1

Open the Shopify App Store

Screenshot for step 1: Open the Shopify App Store
  1. Sign in to your Shopify Admin and open the Shopify App Store.
  2. Search for Witzo.
2

Install the Witzo App

Screenshot for step 2: Install the Witzo App
  1. Open the Witzo app listing.
  2. Click Install.
3

Grant Required Permissions

Screenshot for step 3: Grant Required Permissions
  1. Shopify will display the permissions requested by Witzo.
  2. Review the permissions.
  3. Click Install to continue.
info

These permissions are required for syncing your products, orders, and store information with Witzo.

4

Continue Setup

Screenshot for step 4: Continue Setup
  1. Click Continue Setup.
  2. You will be redirected to the Witzo dashboard to finish account linking.

Witzo Dashboard​

Complete your Witzo account setup and configure your AI assistant.

1

Sign In or Register

Screenshot for step 1: Sign In or Register
  • If you already have a Witzo account, sign in at Login.
  • New users can create an account at Sign Up.
2

Sync Your Shopify Store

Screenshot for step 2: Sync Your Shopify Store

After logging in, synchronize your Shopify store with Witzo.

This process imports:

  1. Products
  2. Store information
  3. Other supported store data
tip

Depending on the size of your store, synchronization may take a few moments.

3

Customize Your AI Widget

Screenshot for step 3: Customize Your AI Widget

Configure your chatbot before publishing.

You can customize:

  • Widget logo
  • Chat header text
  • Welcome message
  • Default language
  • Other chatbot settings
Setup Complete

Once configuration is complete, click Save & Continue. Witzo automatically redirects you back to Shopify Admin.

Enable the Storefront Widget​

The final step is enabling the Witzo widget on your storefront.

1

Open Apps

Screenshot for step 1: Open Apps

Click Manage Embed at the bottom of the screen.

2

Enable the Witzo App Embed

Screenshot for step 2: Enable the Witzo App Embed

Inside the Theme Editor:

  1. Locate Witzo Widget
  2. Toggle it On
3

Save Your Changes

Screenshot for step 3: Save Your Changes

Click Save in the Theme Editor.

Installation Complete​

Your Witzo AI Widget is now installed and live on your Shopify storefront.

Customers can now interact with your AI assistant directly from your online store.

Troubleshooting​

Unable to Install the App​

  • Ensure you are logged in as the Store Owner or have permission to install apps.
  • Verify that your Shopify store is active.
  • Refresh the page and try again.

Unable to Connect to Witzo​

  • Check your internet connection.
  • Sign out and sign back in.
  • Retry the connection process.

Products Not Syncing​

  • Wait a few minutes for synchronization to complete.
  • Refresh the Witzo dashboard.
  • Start synchronization again if necessary.

Widget Not Visible​

  • Confirm that the Witzo App Embed is enabled.
  • Save your theme after enabling the app embed.
  • Refresh your storefront.

Need Help?​

If you encounter any issues during installation, contact Witzo Support.