This article explains how to install the Crisp Live Chat plugin on a WHMCS website.

The Crisp WHMCS plugin lets you display the Crisp chatbox on your customer portal and manage customer conversations directly from the Crisp Inbox.

The plugin is generated from your Crisp workspace. Download it as a ZIP file, install it in WHMCS, then connect it with the license key provided by Crisp.

Watch the WHMCS installation walkthrough

This video shows how to download the Crisp plugin, install it on WHMCS, and confirm that the chatbox is working correctly.

Before you start

Before installing the plugin, make sure that:

• You have access to your Crisp workspace
• You can access your WHMCS administration and installation files
• You have permission to install or update WHMCS modules
• Your WHMCS website is accessible so you can test the chatbox

Download the Crisp WHMCS plugin

The WHMCS plugin can be downloaded directly from your Crisp workspace.

To download it:

1. Open Crisp.
2. Go to Settings → Workspace Settings → Setup & Integrations.
3. Find and open the WHMCS integration.
4. Click the download button to retrieve the plugin as a ZIP file.
5. Keep the license key displayed by Crisp. You will need it during the WHMCS setup.

Install the plugin on WHMCS

Once the ZIP file has been downloaded, add the Crisp plugin to your WHMCS installation.

To install the plugin:

1. Extract the downloaded ZIP file on your computer.
2. Upload the crisp folder to modules/addons/ in your WHMCS installation.
3. Open your WHMCS administration.
4. Go to Addons → Apps & Integrations.
5. Open the Search tab.
6. Search for Crisp.
7. Open the Crisp integration and activate it.
8. Enter the license key provided by Crisp.
9. Save the configuration.

Check the Crisp chatbox

Once the Crisp integration is active, open your WHMCS customer portal as a visitor.

The Crisp chatbox should appear on the pages where the plugin is loaded.

To test the installation:

1. Open your WHMCS website in a private browser window.
2. Check that the Crisp chatbox appears.
3. Send a test message from the chatbox.
4. Open the Crisp Inbox.
5. Confirm that the new conversation appears in the correct workspace.

You can then customize the appearance and behavior of your Crisp chatbox.

Troubleshooting

If the Crisp chatbox does not appear, check the following:

• Plugin folder → confirm that the crisp folder is located inside modules/addons/
• Plugin files → confirm that the folder contains crisp.php and hooks.php
• Integration activation → make sure Crisp is active in Addons → Apps & Integrations
• License key → confirm that the key comes from the Crisp workspace you want to connect
• Caching → clear the WHMCS cache and your browser cache
• Website test → test the installation from a private browser window
• Theme compatibility → temporarily test another WHMCS template if the chatbox only fails on specific pages

If the WHMCS plugin is unavailable or incompatible with your current setup, you can install Crisp manually with the standard HTML chatbox installation guide.

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 use the same plugin on several Crisp workspaces?

The downloaded plugin and license key are associated with a specific Crisp workspace. Download the corresponding plugin from each workspace you want to connect.

Why does the chatbox not appear after installation?

First confirm that the crisp folder is inside modules/addons/, the integration is active in Addons → Apps & Integrations, and the correct license key is configured. Then clear the WHMCS and browser caches before testing again.

Updated on: 29/07/2026