Get started · User Guide

Install and Test the Crisp Chat Widget

Add the Crisp chat widget to your website and verify it works. Check your workspace, send a test message and troubleshoot common installation issues.

01

Before you start

Make sure you have access to the correct workspace and can make changes to the site. First record the website address, the colleague responsible for publishing and the members who are ready to receive the message.

  1. Check the workspace name with the Website ID to avoid connecting the test environment to other teams.

  2. Confirm that the website allows custom JavaScript to be loaded; when using a website builder, first check the script permissions of the current package.

  3. Choose a test page and prepare a post-launch checklist.

02

Add installation configuration

Find the Chatbox setup instructions in Crisp's Settings → Workspace Settings → Setup & Integrations to get the complete installation script.

  1. Add the script to the website shared template, usually before the closing head tag.

  2. Make sure that all pages that require chat entry use this template.

  3. Single-page applications should be loaded once during application initialization to avoid repeated injection every time the page switches.

03

Complete a real session verification

  1. Publish the website and open a new browser window.

  2. Check that the chat portal appears and enter a message that will be recognized as a test.

  3. Confirm the session, page address and message content in the target workspace.

  4. Reply from the workspace, then return to the website to check if the reply has arrived.

The appearance of the entrance on the website is only the first step; the verification is completed only when the messages are sent back and forth successfully.

04

How to troubleshoot when the entrance is not displayed

  1. Verify that the latest templates are published and clear the site or CDN cache.

  2. Check whether the script is complete and the Website ID is correct.

  3. Change the browser window and exclude extensions or network blocks.

  4. If it only fails on some pages, check to see if those pages use the same template.

Continue reading

Getting Started: Your First Crisp ReplyCustomize the Crisp Chat Widget with the SDKAssign Conversations and Collaborate in Crisp
Data sources and content description

This article organizes steps according to usage tasks. For product facts, refer to Crisp corresponding information; process inspections, examples and implementation suggestions are organized by this site. The data address is only used as a source record, and the content of the article is fully displayed on this site.

https://help.crisp.chat/en/article/how-to-install-crisp-live-chat-software-on-a-custom-website-10wcj3l/

Data verification date: November 11, 2026.

Return to top ↑

Your next great customer experience starts here

Better tools for your team.
Better answers for your customers.

14-day free trial · No credit card required

Want to know something?

Search this site's products and content

About Crisp

Video provided by Vimeo.Watch in new window ↗

Chat with the Crisp team

Learn how the product fits into your business processes and explore service options that work for your team.

Organize presentation requirements

Explain your team scenario and the functions you want to know about on the site.

Cookies and external content

This website does not use marketing or analytics cookies. CMS uses necessary session and language cookies; site search and plan recommendations are done locally.

The external player is loaded when playing the video. Online consultation is received by the backend of this site; login and registration are completed by the corresponding business service.

Crisp
Get started free
Find your Crisp