> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.crisp.chat/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# How to install the Crisp live chat software on Adobe Commerce

*Learn how to install Crisp on Adobe Commerce so your store can display the chatbox and sync customer, cart, and order context into Crisp.*

The **Adobe Commerce** integration, formerly Magento, adds the Crisp [chatbox widget](https://crisp.chat/en/livechat/) to your online store and connects store data to your Crisp workspace. This helps your team support e-commerce customers with cart and order context available from the Inbox.

| You can download the Crisp extension from the [Adobe Commerce Marketplace](https://commercemarketplace.adobe.com/crisp-chat-chatbox-and-helpdesk.html).

---

# ${color}[#0080dd](Install Crisp on Adobe Commerce with Composer)

Start from the root directory of your Adobe Commerce or Magento 2 store. Make sure **Composer** is installed before running the commands.

#### ${color}[#445055](Install the extension package)

If your store uses a **Hyvä** theme, use:

```bash
composer require hyva-themes/magento2-crisp-chat-chatbox-and-helpdesk:1.0.0
```

Otherwise, use:

```bash
composer require crisp-chat/chatbox-and-helpdesk:1.0.7
```

Then enable and deploy the module:

```bash
bin/magento module:enable Crisp_Crisp
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy
bin/magento cache:clean
```

|| If Adobe Marketplace shows a newer extension version, use the current version recommended there.

#### ${color}[#445055](Add your Crisp website ID)

1. In Crisp, find your `website_id` from **Settings → Workspace Settings → Setup & Integrations**.
2. In Adobe Commerce, go to **Stores → Configuration → Crisp → Settings**.
3. Paste your `website_id` and save the settings.

After saving, the Crisp chatbox should appear on your e-commerce store.

![Add the Crisp website ID in Adobe Commerce](https://storage.crisp.chat/users/helpdesk/website/87ae2703583ac800/cleanshot-2025-02-28-at-093513_17s6gaf.png =1000xauto)

---

# ${color}[#0080dd](Activate the Adobe Commerce integration)

To see customer carts and orders in Crisp, activate the Adobe Commerce integration after the chatbox is installed.

1. In Adobe Commerce, go to **System → Integrations**.
2. Click **Activate** for the Crisp integration.

![Activate the Crisp integration in Adobe Commerce](https://storage.crisp.chat/users/helpdesk/website/87ae2703583ac800/cleanshot-2025-02-28-at-093526_4rsba3.png =1000xauto)

3. Approve the permissions required to view customer order data.
4. In the Crisp popup, log in and install the Adobe Commerce plugin on your Crisp workspace.
5. Return to Adobe Commerce and confirm the integration is connected.

---

# ${color}[#0080dd](How the Adobe Commerce integration works)

When a customer contacts you through the chatbox, Crisp can show what they currently have in their basket. If the customer has an account on your website and is logged in, Crisp can also display past orders.

![Adobe Commerce cart and order data in Crisp](https://storage.crisp.chat/users/helpdesk/website/a4823be626ad8800/widget-examples_1a4ykvq.png =1000xauto)

---

# ${color}[#0080dd](Download the Adobe Commerce extension)

You can access the extension from the [Adobe Commerce Marketplace](https://commercemarketplace.adobe.com/) by searching for **Crisp**.

---

# ${color}[#0080dd](Troubleshooting)

###### ${color}[#F08820](Why do I see “Invalid store code” in the plugin widget?)

This usually means your store view code is not the default store code. Save the correct store view code in Crisp.

1. In Adobe Commerce, go to **Stores → All Stores**.
2. Look at the **Store View** column and copy the store view code.
3. In Crisp, go to **Plugins → Magento → Settings**.
4. Paste the store view code and save it.

After the correct store view code is saved, customer, cart, and order data should appear in the plugin widget.

![Find the Adobe Commerce store view code](https://storage.crisp.chat/users/helpdesk/website/87ae2703583ac800/cleanshot-2025-02-28-at-093538_kvamd4.png =1000xauto)