message.comDevelopers

Squarespace install Coming soon

Squarespace does not have a public app marketplace, so the install is a guided Code Injection paste. Available on the Business plan and above. We complement the snippet with a one-click Import as KB tool that crawls your Squarespace site into your AI knowledge base.

Code Injection requires a Squarespace Business plan or higher. Personal plans cannot run third-party scripts. See Squarespace's docs for the plan matrix.

Step-by-step install

  1. From your Squarespace dashboard, open Settings → Advanced → Code Injection.
  2. Paste the snippet into the Footer field, not the Header field. Footer injection runs before </body>, which is what we want.
  3. Replace YOUR_WORKSPACE_ID with the ID shown in Settings → Chats → Installation in the message.com dashboard.
  4. Save. Open your site in an incognito window to verify the launcher appears.
Footer Code Injection
<!-- Paste in: Settings → Advanced → Code Injection → Footer -->
<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>

Import your site as a knowledge base

Once the snippet is live, the message.com dashboard prompts you to import your site as a knowledge-base source. We crawl your published pages (respecting robots.txt), chunk the text, generate semantic embeddings, and store them in a vector index for fast retrieval. Your AI now answers from the same material your team wrote.

See AI knowledge base for the underlying mechanics, including how recrawls and updates work.

Per-page injection

If you want chat only on specific pages, leave the global injection off and use the page-level Code Injection block from Page Settings → Advanced → Page Header Code Injection. The same snippet, scoped to that page.

Squarespace Commerce

For Commerce sites we offer an order-context bridge. Once you connect your Squarespace API key in the dashboard, conversations from logged-in customers show their recent orders in the agent sidebar.

  • Read access to orders, products, and customers.
  • No write scopes; we never modify your store.
  • AI tool calls expose order-lookup to the model. See custom tools.

How to verify it loaded

  1. Open your site. Open browser dev tools.
  2. In the Network tab, filter for widget.js. You should see a 200 from app.message.com.
  3. In the Console, type window.Message. The object should be defined within two seconds of page load.

Common pitfalls

  • Header vs Footer. Always paste in the Footer field. Header injection puts the script in <head>, which still works but blocks the render budget.
  • Page-level overrides win. If you have a page-level Code Injection block, it overrides the site-wide one.
  • Cookie banners can block the launcher. If you use a consent manager, allow app.message.com in the functional category.