Add the Crisp live chat widget to your Shopify store so shoppers can ask questions while browsing and your team can answer from the Inbox.

This guide connects the Shopify app and enables the widget on your storefront. Once installation is working, the linked guides help you bring customer and order context into support or let Hugo handle routine lookups.

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. You can also open 🧩 Plugins in the Crisp sidebar and search for Shopify.

Use a desktop browser for the steps below. The person installing the app needs permission to install Shopify apps and edit the online store theme. You can learn more from Shopify’s guide on installing and setting up apps.

Before installing, check whether your theme, tag manager or another app already adds Crisp. Remove the duplicate installation when switching to the app embed.

If you do not have a Crisp account yet, create one first.

Connect the store:

1. In Crisp, open Settings → Workspace Settings → Setup & Integrations and select Shopify.
2. Follow the Get the plugin instructions to open Crisp’s Shopify App Store listing and install the app.
3. Sign in to Shopify if needed and select the store you want to connect.
4. Review the requested permissions and confirm installation from your Shopify admin.
5. Complete the Crisp connection flow for the workspace that should receive this store’s conversations.
6. Return to Plugins → Shopify in that workspace and confirm the connected store. If setup opens the Shopify theme editor, continue with the app embed steps below.

Display the Crisp widget on your storefront

The Crisp Shopify app uses a Shopify app embed to display the widget on your online store.

After installing the app, open Plugins → Shopify in Crisp and find the Crisp App Block section.

Click Enable Crisp App Block or View Crisp App Block to open the Shopify theme editor. The label depends on whether Crisp detects that the embed is enabled.

From the Shopify theme editor:

1. Check that you are editing the theme you intend to publish, then open App embeds.
2. Find Crisp Chatbox.
3. Enable the Crisp app embed.
4. Click Save.
5. Open your public storefront in a private browser window and confirm that the widget appears. A saved change in an unpublished theme is only visible in that theme’s preview.

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.

If you publish a different Shopify theme later, enable and save the Crisp app embed for that theme too.

Send a message from the published storefront and reply from Crisp to check both directions. Repeat on mobile and in each market where you expect chat to appear; app embeds can have market-specific settings. Customer and order synchronization should be tested separately, following the guide linked below.

Temporarily hide or reactivate the widget

You can temporarily disable the widget from your Shopify theme without disconnecting the Shopify integration.

Open the Crisp Shopify plugin settings and click View Crisp App Block, then disable or enable the app embed from Shopify and click Save. This controls the storefront widget; it does not stop customer or order synchronization.

Refresh the Shopify authorization

If Shopify permissions change or Crisp asks for new permissions, click Re-authenticate App from the Shopify plugin settings.

Authorize the same store, return to Crisp and test the affected feature again. Re-authentication updates the store’s authorization; it does not replace the theme’s app embed settings.

Add chat to checkout or the Thank you page

The storefront app embed does not add chat to checkout. Crisp provides a separate chat extension for checkout and the Thank you page. Checkout customization requires Shopify Plus; Thank you page extensions are available on Basic or higher.

In Shopify, open Settings → Checkout, edit the relevant configuration and add the available Crisp chat extension to the supported page. Save, then test a checkout or test order on that page. Follow Shopify’s checkout app instructions for the current editor steps.

Connect more than one store

The native Shopify integration connects one Shopify store to a Crisp workspace. To keep each store’s native customer and order integration, use a separate workspace for each store.

Installing the same widget on several websites is a different setup: it shares a workspace but does not connect several Shopify backends to the native integration.

Choose the next step for your store:

• To give agents order and customer context while they reply, configure Shopify synchronization.
• To let Hugo retrieve current order details for customers, connect the Shopify tools.
• If installation or the connection fails, use Shopify troubleshooting.

Updated on: 03/11/2026