Installing the Weevio Shopify Widget is a straightforward process that typically takes 15-30 minutes. This guide will walk you through the three main steps: preparing your prerequisites, configuring the widget in Weevio Cloud, and adding the code to your Shopify theme.
Installation Overview
The installation process consists of three main steps:
- Prerequisites Setup - Create a Shopify Custom App and gather API credentials
- Weevio Cloud Configuration - Connect your Shopify store and enable features
- Theme Integration - Add the widget code to your Shopify product pages
Before You Begin
Make sure you have:
- Admin access to your Shopify store
- Access to your Weevio Cloud account
- Ability to edit your Shopify theme code
- About 15-30 minutes to complete the setup
Step 1: Prerequisites
Before installing the widget, you'll need to set up a Shopify Custom App with the appropriate API access.
What you'll need:
- Shopify Custom App with Admin API access
- Admin API access token
- Storefront API access token (optional, for improved variant selection)
Learn how to set up prerequisites →
Step 2: Configure in Weevio Cloud
Once you have your Shopify API credentials, connect your store in Weevio Cloud and configure your desired features.
In this step you'll:
- Enter your PIMS settings
- Connect your Shopify store
- Configure order sync webhooks
- Purchase and enable widget features
- Copy your personalized widget code
Learn how to configure Weevio Cloud →
Step 3: Add Widget to Theme
With your widget code copied from Weevio Cloud, you'll paste it into your Shopify theme's product template.
In this step you'll:
- Access your Shopify theme code editor
- Locate your product template file
- Paste the widget code
- Save and publish your changes
- Test the widget on a product page
Learn how to add widget to theme →
Installation Checklist
Use this checklist to track your progress:
- Create Shopify Custom App
- Configure Admin API scopes
- Copy Admin API access token
- (Optional) Configure Storefront API and copy token
- Log into Weevio Cloud
- Configure PIMS settings
- Connect Shopify store with API credentials
- Configure webhook settings
- Purchase desired features
- Copy widget code snippet
- Open Shopify theme editor
- Locate product template file
- Paste widget code
- Save changes
- Test on a product page
- Configure feature flags as needed
Verification
After installation, verify the widget is working correctly:
- Visit a product page in your live store
- You should see shipping estimates or availability information
- Open browser console (F12) and check for errors
- Try changing variants to see the widget update
- (If enabled) Test cross-sell by adding a product to cart
Common Issues
If the widget doesn't appear or isn't working correctly:
- Verify your Team ID and Shopify domain are correct in the widget code
- Check that API credentials are valid (test connection in Weevio Cloud)
- Ensure the widget container
<div id="Weevio-eCommerce-Widget-Root">exists - Check browser console for JavaScript errors
- Verify features are purchased in Weevio Cloud
For detailed troubleshooting, see the Troubleshooting Guide.
Next Steps
After successfully installing the widget:
- Configure additional features based on your needs
- Learn about each feature in detail
- Explore configuration examples for different business models
- Review best practices for optimal performance
Need Help?
If you encounter issues during installation:
- Review the Prerequisites Guide to ensure all requirements are met
- Check the Configuration Guide for detailed setup instructions
- Visit the Troubleshooting Guide for common issues
- Contact Weevio support with your Team ID and Shopify domain
Need Help?
For assistance, please send a message to our Support page.