How it works
floors.js loads as a lightweight script on every page of your Squarespace site. It detects each page URL and creates a room for it. Visitors on the same page see each other as 3D avatars and can chat in real-time.
Your homepage is one room, your about page is another, and each blog post gets its own room. No code, no app, no configuration — just paste one line and your site comes alive.
Installation
Squarespace lets you inject custom code site-wide via the Code Injection panel. Here's how:
- Open your Squarespace dashboard
- Go to Settings → Advanced → Code Injection
- Paste the following in the Footer field
- Click Save
Replace flr_... with your site key from the floors.js dashboard. The script loads asynchronously and won't slow down your site.
What visitors see
Once installed, every page on your Squarespace site becomes a room. A small widget appears in the corner showing who else is on the same page.
- Homepage — visitors browsing your landing page see each other
- About page — potential clients reading about you can chat
- Blog posts — each post is its own room where readers discuss
- Store pages — shoppers see other people browsing the same product
Configuration
Add optional attributes to customize the experience:
src="https://floorsjs.com/embed.js"
data-key="flr_..."
data-server="wss://your-server.com"
data-name="Store Owner"
></script>
- data-key (required) — your site key
- data-server (optional) — custom WebSocket server if self-hosting
- data-name (optional) — pre-set a display name for the visitor