01Install
One snippet, pasted once, powers your whole site. Your personalized snippet — with your license key already filled in — is on the page you landed on right after purchase, and in your receipt email thread.
- Copy your install snippet.
It looks like this (yours has your real key):
<script src="https://calbutton.app/v1/atc-button.min.js" data-license="CB-XXXX-XXXX-XXXX" defer></script> - In Squarespace, open Settings → Advanced → Code Injection.
You'll need a Business plan or higher (code injection is a Squarespace feature).
- Paste the snippet into the Footer box and save.
That's it. The plugin loads on every page but stays invisible until you use it.
03Styling & layouts
CalButton reads your site's own typography and colors, so buttons look native out of the box. The builder's style options let you go further:
Layouts
Single button opens a dropdown of calendar choices. Row of buttons places each calendar as its own button — good for landing pages where you want every option visible.
Icon styles
Logos (the default) shows each calendar service's real logo. Logos · theme color tints them to match your palette. Minimal uses clean line icons for quieter designs.
04Event pages — automatic
If your site uses Squarespace's Events pages, CalButton upgrades them without any work from you:
- Event detail pages
Squarespace's plain "Google Calendar / ICS" text links are replaced with a proper CalButton — full menu, your styling, and the event's real description in the invite.
- The calendar / list page
Each event gets a tidy "Add to Calendar" text link under its listing, so the page stays clean.
Turning it on or off
It follows Squarespace's own setting: in your Events page settings, the Show Export Links toggle (under Advanced) controls it. Toggle off, and CalButton steps back too. No code, no extra switches.
05License & domains
Your key is validated quietly in the background about once a day.
| Plan | Covers |
|---|---|
| Single site | One website — up to 3 hostnames, which covers your built-in .squarespace.com address, your custom domain, and its www twin. They're claimed automatically as your site loads; www and the bare domain count as one. |
| Designer | Unlimited websites with one key. Made for designers and agencies installing for clients. |
Fail-soft, always
If our license server is ever unreachable, your buttons keep working. Validation only disables buttons on an explicit "invalid key" or "over the domain limit" answer — an outage on our side can never break your site.
Lost your key?
It's tied to your purchase email. Reply to your Stripe receipt and we'll send it right back.
06FAQ
Which calendars are supported?
Google Calendar, Apple Calendar, Outlook.com, Office 365, Yahoo Calendar, and a universal .ics download that works with everything else. On iPhone the .ics option opens straight into the Calendar app.
Will it slow my site down?
No. It's one small script (~59 KB, about the weight of a single small photo), loaded with defer so it never blocks your page from rendering. There are no frameworks and no third-party embeds.
Does it send my visitors' data anywhere?
No. Calendar links and .ics files are generated right in the visitor's browser. No analytics, no tracking, no third-party servers involved in the click.
Are time zones handled correctly?
Yes — events are stored as exact universal instants, so a 6:30 PM event in your time zone shows up at the right local time for every visitor, everywhere.
One thing to check: your site's own time zone setting (Settings → Language & Region). If that's set to the wrong region, Squarespace itself mislabels your event times, and every calendar tool — ours included — inherits the mistake.
Does it work with Squarespace 7.0?
CalButton is built and tested for Squarespace 7.1. Most 7.0 templates work for the footer-snippet basics, but the in-editor builder targets 7.1 — if you're on 7.0, try it and reply to your receipt if anything's off.
Can I use it on a page without the editor, like a campaign page?
Yes — the builder ultimately produces a small block of markup. Create the button on any normal page, and copy its code block into wherever you need it.
Do you offer refunds?
If it doesn't work on your site and we can't fix it, you get your money back — just reply to your receipt within 14 days of purchase.
07Troubleshooting
| Symptom | Fix |
|---|---|
| Block doesn't appear in the + menu | Check the snippet is in Footer (not Header) under Settings → Advanced → Code Injection, saved, and that you've refreshed the editor tab once after saving. |
| Button looks unstyled for a moment | Normal on the very first load after install — the script is deferred. It won't happen for visitors on repeat views. |
| A change I made isn't showing | Plugin updates can take up to ~5 minutes to reach every visitor (CDN caching). Hard-refresh (Cmd/Ctrl + Shift + R) to see it immediately. |
| Event shows the wrong time in calendars | Your site's time zone is likely set to the wrong region — Settings → Language & Region. Fix it there and re-save the event. |
| Buttons vanished, console mentions a license | The key was used on more sites than the plan allows, or the key is mistyped in the snippet. Compare against the key in your receipt thread — and if it's a domain-limit surprise, reply to your receipt and we'll sort it out. |
| Event page buttons missing | Check Show Export Links is on in that Events page's settings (Advanced tab). CalButton follows that switch. |
08Support
Reply to your Stripe receipt email — it reaches a human (the person who built this), usually within a day. Include your site's URL and, if something's visibly wrong, a screenshot. Lost keys, domain-limit fixes, weird templates: all fair game.