Docs
Add VoxelEon to Squarespace
Squarespace does not have an app store for chat widgets, so the install is a guided copy and paste. The VoxelEon dashboard walks you through it and confirms when the widget is live.
Before you start: your Squarespace plan
Code injection needs a Squarespace Core, Plus or Advanced plan (or a legacy Business or Commerce plan). Personal and Basic plans cannot run custom JavaScript, and there is no workaround: upgrade your Squarespace plan, then follow the steps below. Check Squarespace's current plan names if yours looks different.
1. Open the Squarespace guide in VoxelEon
In VoxelEon go to Settings → Inboxes, open your website inbox, and choose the Squarespace tab. Enter your site address and press Continue. We can check the address first to confirm it is a Squarespace site.
2. Paste the snippet
Copy the snippet from the guide. In Squarespace open Settings → Developer Tools → Code Injection, paste it into the Footer box, and save.
3. Verify the installation
Press Verify installation. VoxelEon waits up to two minutes for the widget to load on your published site, and also looks for the snippet on your homepage. You will see one of:
- Installed: the widget has loaded on your site.
- Snippet on your published site: it appears on the next page view.
- Snippet not found: check you saved it in the Footer box, the site is published, and it is not password protected.
Once the install is confirmed, the widget is locked to your site address and your squarespace.com preview address, so the token cannot be used on someone else's site.
Password-protected and trial sites
Squarespace trial sites and password-protected sites cannot be checked from outside, so verification may report that the site cannot be reached. Publish the site, remove the site password, then verify again.
Hide the launcher on specific pages
On the page you want to change, open Page Settings → Advanced → Page Header Code Injection and add:
<script>
window.voxeleonSettings = { hideMessageBubble: true };
</script>You can still open the chat from your own button by calling:
window.$voxeleon.toggle('open');Not supported on Squarespace
Squarespace does not expose signed-in customer details to injected scripts, so visitors are not identified automatically.
Send form submissions to VoxelEon (optional)
Your site builder's forms can send leads to VoxelEon through Zapier. In the same VoxelEon tab press Create a key for Zapier and copy it (it is shown once). In Zapier add a Webhooks by Zapier action: a POST to https://app.voxeleon.com/api/v1/connect/leads with the header Authorization: Bearer YOUR_KEY, an Idempotency-Key header set to the form entry id, and name, email, phone (international format) and message in the body. Each submission appears as a contact with a conversation labelled with the platform.
Need help?
Email hello@voxeleon.com and we'll help you get the widget live.