Step by step
How to connect Squarespace and add the timer to your emails
Generate a read-only API key
In Squarespace open Settings → Developer tools → Developer API keys and click Generate key. Set Discounts and Products to Read only and leave the rest off, then copy the key: Squarespace shows it once. The Squarespace setup guide goes through it button by button.
Connect the store in flashtimer (Pro and up)
Under Settings → Integrations → Squarespace, paste the key. flashtimer tries it before saving anything, and says what is wrong if Squarespace refuses it, if it can't read your discounts, or if your site's plan doesn't include Squarespace's Commerce APIs.
Link a timer to a discount
In the timer editor, click Link a promotion and choose Squarespace. You see your discount codes and automatic discounts that are running or yet to start. Pick one and the countdown takes its end date, or its start date if it hasn't begun.
Choose what flashtimer does by itself
Tick Auto-create, Auto-update and Auto-archive timers and flashtimer keeps timers in step with your store, checking it every few minutes. Everything is off until you tick it.
Copy the embed for your email platform and test
Click Embed and copy the image URL or the HTML
<img>snippet. Under the timer, add a line like "Code FALL20 ends Sunday at 11:59pm". Send a test, then change the discount's end date in Squarespace and reopen the test a few minutes later: the countdown follows.
Why a store-connected countdown beats a typed-in date
Most email countdown timers make you type the deadline twice: once on the discount in Squarespace, once in the timer tool. When the sale is extended by a day, someone has to remember the second one, and until they do your emails count down to the wrong time. A connected timer reads the date from Squarespace, so there is one source of truth.
flashtimer reads every kind of Squarespace discount through its Discounts API: a percentage or fixed amount off, free shipping, and Buy X Get Y, whether shoppers type a code or it applies by itself. A discount that hasn't started counts down to its start, and a code with no uses left counts as over. Store connection and promotion sync are on Pro and up; the timer itself works on every plan.
What Squarespace can and can't tell a timer
Squarespace has no way to tell another service the moment a discount changes: its notifications cover orders and customers, and only apps installed through Squarespace's own sign-in may receive them. So flashtimer checks your store every few minutes instead. A change reaches your timers within minutes, never instantly, and nothing has to be installed on your site.
A product's sale price is a switch in Squarespace, with no start or end date. With no deadline to count down to, a timer can't follow it, so sales aren't listed. To run a timed sale, make a discount with an end date (an automatic one, if shoppers shouldn't need a code), or set the timer's end date yourself.
Automatic timers, without a timer for every one-off code
With the choices ticked, a new discount gets its own timer, a changed end date moves the countdown (including in emails already sent, because the GIF is rendered at each open), and a discount that is deleted, over or used up has its timer archived. Give an ended discount a new date and its timer comes back.
Apps that reward customers often make a code for each one, usable once. Those are left out, so your timer list holds campaigns, not hundreds of personal codes. If you do want timers for them, tick Include single-use codes.
- Auto-create timers: a new discount becomes a timer.
- Auto-update timers: a changed end date moves the countdown.
- Auto-archive timers: a discount that is deleted, over or used up archives its timer.
End a timer when a product sells out
On Business, Stock Monitor ends a timer early when a product runs low, counting all of its variants together, so the email stops promising what you can no longer ship. A product set to unlimited stock can't run out, so it never ends a timer. Stock Monitor needs the key's Products permission.
Squarespace never lets a key's permissions change. If you connected with Discounts alone and want Stock Monitor later, generate a new key with both and click Use a new API key in flashtimer: your choices and timers stay as they are.
Put the timer in any email platform your store uses
The timer is an image URL, so it works in Squarespace Email Campaigns and in every other email platform: paste it into an image block, or paste the HTML snippet into a custom HTML block. For per-recipient features, pick your platform in the embed dialog and flashtimer adds its merge tag where it has one, as for the Mailchimp countdown timer or the Klaviyo countdown timer.
A discount countdown is the classic flash sale countdown timer email, and for the biggest weekend of the year see the Black Friday countdown timer email playbook.
After the discount ends, and troubleshooting
When the discount ends, the timer shows your expiry message, or your own fallback image on Basic and up, so a shopper who opens next week is not sent to a code that no longer works.
Connection refused? The message says which of these it is: Squarespace didn't accept the key, the key wasn't given the Discounts permission, or the site's plan doesn't include Squarespace's Commerce APIs. If the site's subscription lapses, flashtimer says so and picks the store up again once it is renewed.
Questions
Answered before you ask.
Keep reading
- Squarespace setup guideConnect Squarespace to flashtimerGenerate a read-only API key, paste it and connect. Step by step.
- WooCommerce integrationWooCommerce email countdown timer that follows your couponsA WooCommerce email countdown timer that follows your coupon and sale end dates. No plugin, just REST API keys. Works in any email platform. Start free.
- Shopify integrationShopify email countdown timer for your sales and discountsAdd a live Shopify email countdown timer to Shopify Messaging campaigns, and turn Shopify discounts into timers that update themselves. Start free today.
- Flash salesFlash sale countdown timer email: run a 24–72 hour sale that ends on timeBuild a flash sale countdown timer email for 24–72 hour sales: send schedule, subject lines, last-chance resend and timers that update on open. Start free.
- Black Friday & Cyber MondayBlack Friday countdown timer email: the 2026 playbookPlan your Black Friday countdown timer email for 2026: teaser, launch and last-chance sends, Cyber Monday timers and fallbacks after the sale. Start free.