Wedding Countdown Widget

Free, customisable countdown to your wedding day. Paste an iframe into Squarespace, Wix, WordPress, Webflow — any website builder that accepts custom HTML. Custom names, accent color, and Google Fonts via URL.

Live preview
Copy this iframe
<iframe src="https://gotimer.org/e/countdown?duration=2592000&label=Sarah+%26+Alex&theme=light&accent=%23d4af37&font=Playfair+Display"
  width="100%" height="420" frameborder="0"
  allow="autoplay" loading="lazy"
  style="border-radius:12px;border:0;max-width:480px;"></iframe>

Edit "Sarah+%26+Alex" and the duration in the iframe URL to set your own names and wedding date.

How to use this on your wedding website

  1. Copy the iframe markup above (or build a different one on /embed).
  2. Open your wedding site editor and find the "custom HTML", "embed code", or "iframe" block. On Squarespace it's called Code Block; on Wix it's HTML iFrame; on Webflow it's the Embed component.
  3. Paste the markup, swap the label=… for your names, and replace the duration=2592000(30 days in seconds) with seconds-until-your-wedding. For most weddings you'll do that once and never touch it again.
  4. Save and preview. The countdown ticks down in real time for every visitor.

Computing seconds until your wedding

Quick formulas:

  • 30 days: 2592000
  • 60 days: 5184000
  • 90 days: 7776000
  • 180 days (6 months): 15552000
  • 365 days (1 year): 31536000
  • Custom: in your browser console type Math.floor((new Date('2027-06-15T16:00') - Date.now()) / 1000) — paste the resulting number into the URL.

A future version will accept date=YYYY-MM-DDdirectly so this calculation goes away. For now, the seconds value "freezes" when you set it — the embed counts down from that moment in real time, so it stays accurate.

Color palettes that match common wedding themes

  • Champagne & gold: accent=%23d4af37 (gold), pair with theme=light.
  • Romantic blush: accent=%23e8b4b8, theme=light.
  • Classic black-tie: accent=%23ffffff, theme=dark, bg=%23111111.
  • Garden / forest: accent=%2334a56e, theme=light.
  • Beachside teal: accent=%2300a0a8, theme=light.
  • Burgundy autumn: accent=%23800020, theme=dark, bg=%23fefaf5.

Font pairings

The embed accepts any Google Font name via font=. A few combinations that feel wedding-appropriate:

  • font=Playfair+Display — classic serif, pairs with most invitation suites.
  • font=Cormorant+Garamond — refined serif, elegant italic glyphs.
  • font=Italiana — high-contrast art-deco serif.
  • font=Great+Vibes — formal script, good for the names but harder to read at small sizes.
  • font=Cinzel — capitals-only Roman serif, dramatic.

Common edge cases

  • Timezone— by default the countdown is computed from the visitor's local time. For an event that's timezone-anchored (e.g., the ceremony starts at 4:00 PM in Bali regardless of where the visitor is), use the wall-clock number of seconds from now until the event in Bali — visitors in Tokyo will see the countdown adjusted to their wall clock.
  • After the wedding — once the timer hits zero it shows the expired state (or your custom expired_message). For a permanent "we're married!" banner, swap the iframe out for a static image after the day.
  • Mobile sizing — set width="100%"on the iframe (already done in the markup above) and the timer will scale to your wedding site's content column.

Related

Event Countdown Embed

Generic event countdown for conferences, launches, and webinars.

Embed Widget Hub

All timer types, full configurator, more templates.

Custom Countdown Timer

Build a one-off countdown for a date or duration.

Wedding Countdown Widget FAQ

Will the countdown stay accurate after my visitors refresh the page?
Yes. The embed encodes your wedding date in the URL, so every page load recalculates "time remaining" from the visitor's clock. No server polling, no drift, accurate down to the second across timezones (the date is interpreted in the visitor's local timezone unless you pass tz).
Does the widget work on Squarespace, Wix, and The Knot?
Squarespace (Code Block), Wix (HTML iFrame / Embed widget), Webflow (Embed component), Zola, Joy, Minted, WeddingWire, and any builder that allows custom HTML or iframe blocks all work. The Knot's default editor doesn't allow custom HTML on the free tier — you'll need a paid plan or a self-hosted wedding site for that one.
Can I customise the names and colors?
Yes — both via URL parameters. label=Sarah+%26+Alex displays the names; accent=%23d4af37 sets the ring to gold (URL-encoded hex). Use the configurator on /embed to preview live, or copy the iframe markup from this page and edit the URL params by hand.
Can I use a Google Font like Playfair Display?
Yes. Add font=Playfair+Display (URL-encoded with + for spaces) to the iframe URL. Any Google Font name works. The embed lazy-loads the font from Google so no setup needed on your wedding site.
Is the &quot;Powered by GoTimer&quot; attribution removable?
Not on the free tier. A paid no-watermark tier is on the roadmap and likely the right choice for a wedding site, where brand purity matters more than for, say, an OBS scene. In the meantime, the attribution is small and corner-positioned.
What happens when the countdown reaches zero?
By default the embed displays "00:00:00" with a celebratory ring fill. You can pass expired_message=Welcome to show custom text once the date arrives — useful if you want the embed to switch to a welcome message on the wedding day itself.