Websites and stores · Add the booking widget to your site
Retime for Squarespace
Squarespace has no app store, so there is no app to install. You add Retime with a code block on a page, or with code injection for the whole site. The steps below use the real widget code.
What you get
No app store, no plugin
The widget is plain HTML and JavaScript, so it works on any Squarespace template.
Visitors stay on your page
The booking form opens inside your layout, not on another address.
The frame grows with the form
The booking page reports its height, and the script sets the frame to match.
Only your domain can load it
Retime refuses to load in a frame on a domain that is not on your allowed list.
How to connect Squarespace
Copy your embed key
In Retime, open Organization, then Embed. Copy the embed key. The same page lists the domains that are allowed to show the widget.
Copy the event type slug
Open Links, choose the event type, and take the last part of its booking address. That part is the slug.
Turn on embedding for the event type
Open the event type, then Booking extras, and turn on Allow embedding on external sites. An event type with the setting off shows an empty widget.
Add your Squarespace domain
In Retime, open Organization, then Embed, and use Add a website to enter the exact domain, for example https://www.example.com. Until the domain is on the list, the widget stays empty.
Open the page editor
In Squarespace, open Pages, choose the page, and click Edit. Click a plus sign where the widget belongs, then choose Code. Squarespace calls this the code block, and it needs the Business plan or higher.
Paste the code
Set the block type to HTML and turn Display Source off. Paste the snippet below, then replace YOUR_EMBED_KEY and YOUR_EVENT_TYPE_SLUG with your own values.
Save and publish
Click Save, then publish the page. The code block does not run in the editor, so open the live page to see the widget.
For every page at once, use code injection
Open Website, then Website Tools, then Code Injection, and paste only the script part in the Footer field. Then put the div on each page that needs the widget. The script does nothing on a page without the div.
Squarespace code block or code injection
<div id="retime-booking" style="max-width:900px;margin:0 auto"></div>
<script>
(function () {
var mount = document.getElementById('retime-booking');
if (!mount) return;
var origin = 'https://app.retime.so';
var key = 'YOUR_EMBED_KEY';
var slug = 'YOUR_EVENT_TYPE_SLUG';
var frame = document.createElement('iframe');
frame.src =
origin + '/embed/' + encodeURIComponent(key) + '/' + encodeURIComponent(slug);
frame.title = 'Book a time';
frame.loading = 'lazy';
frame.allow = 'clipboard-write';
frame.style.width = '100%';
frame.style.border = '0';
frame.style.display = 'block';
frame.style.minHeight = '600px';
window.addEventListener('message', function (event) {
if (event.origin !== origin) return;
if (event.source !== frame.contentWindow) return;
var data = event.data;
if (data && data.type === 'retime:resize' && typeof data.height === 'number') {
frame.style.height = Math.max(200, Math.min(data.height, 4000)) + 'px';
}
});
mount.appendChild(frame);
})();
</script>The editor preview does not run the script. Save the page, then open the live address to test it.
Questions about Squarespace
Is there a Retime app in a Squarespace app store?
No. Squarespace has no app store for this kind of tool. The code block above is the supported way to add Retime.
Which Squarespace plan do I need?
A code block that runs a script needs the Business plan or higher. Code injection under Website, then Website Tools, needs the same plan.
The widget area is empty. What went wrong?
Check four things. The event type has to allow embedding on external sites. The domain has to be on the allowed list. The embed key has to match your organization. The code block has to be HTML with Display Source off.
Can I show a different service on each page?
Yes. Paste the same code on each page and change YOUR_EVENT_TYPE_SLUG to the event type for that page.
Does the widget work on mobile?
Yes. The frame fills the width it is given, and the booking form lays out for small screens.
Put Squarespace to work
Create a free account, connect your calendar, and share your first booking link today.