message.comDevelopers
Developers/Tutorials/Install on Squarespace

Install live chat on Squarespace

Add the message.com chat widget to a Squarespace site with one paste into Code Injection. Three minutes end to end. Works on Squarespace 7.1 and the older 7.0 platform.

Code Injection requires a Business, Commerce Basic, or Commerce Advanced plan. Personal plans cannot inject custom scripts.

Before you begin

  • Squarespace site on a Business or Commerce plan.
  • Owner or Administrator role on the site.
  • Your install snippet from Settings → Chats → Installation in message.com.
HTML
<!-- message.com live chat -->
<script>
  (function(d,s,o){
    var j=d.createElement(s);j.async=1;j.src='https://app.message.com/widget.js';
    j.dataset.workspace=o;
    d.head.appendChild(j);
  })(document,'script','YOUR_WORKSPACE_ID');
</script>

1. Open Code Injection

  1. Sign in to Squarespace.
  2. Open the site you want to add chat to.
  3. From the Home Menu, go to Settings → Advanced → Code Injection.
  4. You will see two text areas: Header and Footer.

2. Paste the snippet

  1. Paste the snippet into the Footer text area (not Header).
  2. Click Save.

The Footer panel renders the snippet right before the closing </body> tag on every public page, which is exactly where the install belongs.

3. Verify the install

  1. Open your site URL in a private window (not the Squarespace editor preview, which strips injected code).
  2. Wait two seconds. The launcher appears in the bottom-right.
  3. Open the browser console. Confirm the [message] startup log.
  4. Click the launcher, send a test message.
  5. Open app.message.com. The visitor and message appear in the inbox.

Common pitfalls

  • Squarespace editor preview. Code Injection is stripped from the in-app preview. Always test on the public URL.
  • Member areas and password-protected pages. Code Injection runs on the page after sign-in. The widget loads, but anonymous visitors on the lock screen do not see it.
  • Lock screen. The single-page lock screen for password-protected sites strips Code Injection by design.
  • Squarespace 7.0 vs 7.1. Both platforms support Code Injection identically. No version-specific differences.
  • Another chat app already installed. Disable any prior Squarespace chat extension (Acuity, Drift, Intercom) before installing.

Per-page installs

Squarespace also exposes a Per-page Code Injection field under each page's settings. Use this if you want the widget on one page only. Otherwise stick with the site-wide Footer setting.

Next steps