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.
Check the workspace name with the Website ID to avoid connecting the test environment to other teams.
Confirm that the website allows custom JavaScript to be loaded; when using a website builder, first check the script permissions of the current package.
Choose a test page and prepare a post-launch checklist.
Add installation configuration
Find the Chatbox setup instructions in Crisp's Settings → Workspace Settings → Setup & Integrations to get the complete installation script.
Add the script to the website shared template, usually before the closing head tag.
Make sure that all pages that require chat entry use this template.
Single-page applications should be loaded once during application initialization to avoid repeated injection every time the page switches.
Complete a real session verification
Publish the website and open a new browser window.
Check that the chat portal appears and enter a message that will be recognized as a test.
Confirm the session, page address and message content in the target workspace.
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.
How to troubleshoot when the entrance is not displayed
Verify that the latest templates are published and clear the site or CDN cache.
Check whether the script is complete and the Website ID is correct.
Change the browser window and exclude extensions or network blocks.
If it only fails on some pages, check to see if those pages use the same template.
Continue reading
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.





