How to install Crisp Live Chat on Shopify Stores and connect Hugo AI Agent
This article explains how to install Crisp Live Chat and knowledge base on Shopify, synchronize ecommerce data, and connect Shopify tools to Hugo AI Agent and Copilot.
The Crisp Shopify integration connects your online store to Crisp so your team can talk with shoppers, access customer and order context, and automate ecommerce support from one shared Inbox.
Once the Shopify app is installed, you can also connect it to Hugo so your AI Agent and support operators can retrieve or update selected Shopify information during customer conversations.
In this guide, you will learn how to:
- Watch the Shopify installation walkthrough → follow the complete setup in video format
- Understand what the Shopify integration adds → see how Crisp connects support and ecommerce data
- Install Crisp on Shopify → connect your store to your Crisp workspace
- Display the Crisp chatbox on your storefront → activate the Crisp app block in your Shopify theme
- Configure Shopify contact and order synchronization → control which ecommerce events are synchronized
- Use Shopify data in the Crisp Inbox → give operators useful customer and order context
- Automate support with Shopify data → build workflows and personalized support processes
- Connect Shopify to Hugo AI Agent and Copilot → let Hugo use selected Shopify tools
- Troubleshoot the Shopify integration → fix common installation, synchronization, and AI issues
- Review frequently asked questions → find answers to common Shopify setup questions
Watch the Shopify installation walkthrough
This video shows how to install Crisp on a Shopify store, display the chatbox, and connect your ecommerce data to Crisp.
What the Shopify integration adds
The Crisp Shopify app brings your support conversations and ecommerce context together.
Instead of switching between Crisp and Shopify whenever a customer asks about an account, cart, or order, your team can access supported store information directly from Crisp.
Feature | What it adds |
|---|---|
Crisp Live Chat | Display the Crisp Chatbox on your Shopify storefront |
Customer synchronization | Create or update Crisp contacts using Shopify customer information |
Order activity | Add supported Shopify order events to customer profiles |
Inbox context | Give operators access to customer and ecommerce information during conversations |
Workflows and automation | Use synchronized data to personalize and automate customer support |
Hugo AI Agent tools | Let Hugo retrieve or update selected Shopify information |
Hugo Copilot tools | Help operators investigate Shopify requests from the Crisp Inbox |
You can learn more about the overall integration on the Crisp Shopify integration page.
Install Crisp on Shopify
You can start the installation from Crisp or directly from the Crisp app listing on the Shopify App Store.
The steps below start from your Crisp workspace.
To install Crisp on Shopify:
- Open Crisp or create an account from the Crisp signup page.
- Go to Settings → Workspace Settings → Setup & Integrations.
- Select Shopify.
- Click Get the plugin.
- On the Crisp Shopify plugin page, click Install.
- Continue to the Shopify App Store and confirm the installation.
You can also start from Plugins in the Crisp sidebar and search for Shopify.


- Log in to your Shopify account if needed.
- If you manage several stores, select the store you want to connect.

- Review the requested permissions and install the app from your Shopify admin.

- Choose whether the Crisp Chatbox should be displayed on your storefront.

- Return to Crisp and confirm that the Shopify plugin is connected.
Display the Crisp chatbox on your storefront
The Crisp Shopify app uses a Shopify app block to display the chatbox on your online store.
After installing the app, open Plugins → Shopify in Crisp and find the Crisp App Block section.
Click View Crisp App Block to open the Shopify theme editor.
From the Shopify theme editor:
- Open the App embeds section.
- Find the Crisp app.
- Enable the Crisp app embed.
- Click Save.
- Open your public storefront and confirm that the chatbox appears.
Shopify app embeds are designed for elements that appear across the storefront, such as a chat bubble. You can learn more from Shopify’s guide on extending themes with apps.
Temporarily hide or reactivate the chatbox
You can temporarily disable the chatbox from your Shopify theme without disconnecting the complete integration.
Open the Crisp Shopify plugin settings and click View Crisp App Block, then disable or enable the app embed from Shopify.
Refresh the Shopify authorization
If Shopify permissions change or Crisp asks for new permissions, click Re-authenticate App from the Shopify plugin settings.
This refreshes the connection without requiring you to rebuild your complete setup.
Configure Shopify contact and order synchronization
The Shopify plugin includes several preferences that control how contacts and order activity are synchronized with Crisp.
Open Plugins → Shopify and review the Shopify Preferences section.

Automatically Sync Shopify Contacts
When this setting is enabled, Shopify contacts that are created or updated are automatically synchronized with Crisp.
This helps keep customer profiles up to date and reduces the need to recreate contact information manually.
Automatically Create Contact on Order Events
When an order is created or updated in Shopify, Crisp can automatically create a contact if no matching Crisp profile exists.
This is useful when the first known interaction with a customer comes from an order rather than a support conversation.
Sync Shopify Order events to Crisp Contact
When a matching contact already exists in Crisp, supported Shopify order events can be attached to that contact.
This gives your team more context about the customer’s ecommerce activity while handling a support request.
Use Shopify data in the Crisp Inbox
Once the integration is connected, Shopify context can become available from customer profiles and conversations in the Crisp Inbox.
Depending on the available data and your configuration, operators can access information such as:
- Customer identity and contact details
- Previous Shopify orders
- Order status
- Shipping and tracking information
- Cart or ecommerce context
- Shopify events connected to the customer profile
Synchronized Shopify details

Shopify context inside the Crisp Inbox

This helps agents understand the customer’s situation without repeatedly asking for information that is already available in Shopify.
For broader advice on organizing ecommerce customer support, read Getting started for the ecommerce industry.
Automate support with Shopify data
Shopify customer and order information can also support more personalized workflows and routing inside Crisp.
Common use cases include:
- Customer segmentation → organize customers using synchronized ecommerce information
- Order-related workflows → trigger support processes around order activity
- Personalized replies → use available customer context when preparing a response
- Conversation routing → direct billing, shipping, or VIP requests to the right team
- Multichannel support → keep Shopify context available when customers contact you from different channels
- Proactive support → respond to ecommerce activity with relevant messages or campaigns

Useful guides:
- Understanding and mastering Crisp Workflows
- Getting started with segments
- Getting started with custom data
- How to route and assign conversations to operators in Crisp
Connect Shopify to Hugo AI Agent and Copilot
After connecting the Shopify plugin, you can also make selected Shopify tools available to Hugo AI Agent and Hugo Copilot.
This allows Hugo to use current Shopify information during customer conversations instead of relying only on static training resources.
Go to AI Agent → Automate → Integrations & MCP → Shopify.

Enable the Shopify integration
Turn on Enable the Shopify integration.
When enabled, Hugo can use the integration when a customer request matches one of the available Shopify tool descriptions.
Choose where Shopify tools are available
You can decide whether Shopify tools should be available to:
- Customers → Hugo AI Agent can use them while handling customer conversations
- Copilot → support operators can use them while working with Hugo Copilot
You can enable one option or both, depending on whether you want customer-facing automation, operator assistance, or both.
Select the Shopify tools Hugo can use
The Shopify integration includes tools that can retrieve or update specific store information.
You can enable each tool individually.
Shopify tool | What it allows Hugo to do |
|---|---|
Get Order Details | Retrieve information about a specific order, including its status, shipping details, and tracking information |
Get Customer Address | Retrieve the current default address associated with a Shopify customer |
Update Order Shipping Address | Update selected shipping address fields while the order is still eligible for modification |
Only enable tools that are useful for your customer support process.
For example:
- Enable Get Order Details when customers frequently ask about shipping or order status
- Enable Get Customer Address when operators need to confirm the address attached to a Shopify account
- Enable Update Order Shipping Address when you want Hugo to help customers correct an address before fulfilment
Configure tool parameters
Some Shopify tools need parameters such as an order ID or customer email address.
Open the Parameters section of a tool to configure how Hugo should obtain each value.

When a parameter is set to Let Hugo decide, Hugo can obtain the required information from:
- The customer’s current message
- The conversation history
- Information already available in Crisp
- A direct question to the customer
- The result returned by another connected tool
For example, if a customer asks about order #1033, Hugo can use that order number when calling Get Order Details.
Require user identity verification
Shopify tools may access personal information or modify an order.
Enable Require user identity verification when Hugo should confirm that the person requesting the action is authorized to access the Shopify account or order.
Identity verification can be configured for the integration and for supported individual tools.
This is especially important for actions such as:
- Retrieving private customer information
- Viewing detailed order data
- Accessing a saved customer address
- Updating an order shipping address
Review tools before enabling them
Before using Shopify tools with customers:
- Enable only the tools your support workflow needs.
- Review their descriptions and parameters.
- Configure identity verification for sensitive actions.
- Test the integration with realistic customer questions.
- Review how Hugo uses the tools from AI Observability.
For more details about AI integrations, read How to use Hugo Integrations.
Troubleshooting
If the chatbox does not appear, Shopify data is missing, or Hugo cannot use a tool, review the relevant part of your setup.
The chatbox does not appear
Check that:
- The Crisp app embed is enabled in the Shopify theme editor
- Your theme changes were saved
- You are testing the currently published Shopify theme
- The widget display option is enabled in Crisp
- The page supports Shopify app embeds
- You enabled the app embed again after changing themes
Shopify contacts or order events are missing
Check that:
- The relevant synchronization preference is enabled
- The correct Shopify store is connected
- The app still has the required permissions
- The customer information matches an existing Crisp contact
- The app has been re-authenticated after permission changes
Hugo cannot use a Shopify tool
Check that:
- The Shopify integration is enabled in AI Agent → Automate → Integrations & MCP
- The required tool is selected
- The tool is available to Customers, Copilot, or both
- Hugo can obtain every required parameter
- Identity verification has been completed when required
- The requested action is still allowed, such as updating an order before fulfilment
Frequently Asked Questions
Still have questions which were not covered in this article? Here is a collection of the most frequently asked questions on this topic.
Can I hide the Crisp chatbox without uninstalling the Shopify app?
Yes. Open the Shopify plugin settings in Crisp, click View Crisp App Block, and disable the Crisp app embed from your Shopify theme.
This keeps the Shopify connection in place while hiding the chatbox from the storefront.
Can Crisp appear on Shopify checkout pages?
The Crisp widget can only appear on Shopify checkout pages when the store supports the required checkout customization through Shopify Plus.
Without Shopify Plus, the widget can still appear on supported storefront pages such as product, collection, and content pages.
Can Crisp create a contact when a Shopify order is created?
Yes. Enable Automatically Create Contact on Order Events from the Shopify plugin preferences.
When an order is created or updated and no matching Crisp contact exists, Crisp can create one automatically.
Can Hugo AI Agent retrieve Shopify order details?
Yes. Enable the Shopify integration for Customers, then activate the Get Order Details tool.
Hugo can use the tool when it has the required order information and the customer request matches the tool description.
Can Hugo update a Shopify shipping address?
Hugo can use the Update Order Shipping Address tool when it is enabled and the order is still eligible for modification.
Only the address fields provided to the tool are updated. Existing values remain unchanged for omitted fields.
Why should I enable identity verification?
Identity verification helps protect private customer and order information.
It is recommended before allowing Hugo to retrieve sensitive data or modify Shopify information on behalf of a customer.
Updated on: 22/07/2026
Thank you!