Squarespace integration

Squarespace email countdown timer that follows your discounts

A Squarespace email countdown timer from flashtimer counts down to the real end date of your discount code or automatic discount, and keeps up when you change it. Connect your store with a read-only Developer API key, then put the live timer in emails from Squarespace Email Campaigns, Mailchimp, Klaviyo or any other email platform.

  • Free plan: 3 timers, 20,000 views a month, no card
  • Cancel a paid plan any time and keep it to the end of the period you paid for
See it work in 53 seconds

Step by step

How to connect Squarespace and add the timer to your emails

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.