EMBEDDABLE WIDGETS

Put a live countdown on your site

A self-updating countdown widget for any event, embeddable with a single iframe. Free, no account, no API key — just generate and paste.

Pick an event

Type any tracked event slug, or free text like a date — same rules as the Countdown API.

Choose a theme

Light or dark, matched to your site automatically or set manually.

Paste the iframe

One line of HTML. The widget ticks live, no JavaScript required on your end.

Generate your embed

Customize below — the preview and code update instantly.

Event

Theme

Preview

Embed code

<iframe src="https://howlonguntilx.com/embed/widget?event=christmas&theme=light" width="300" height="160" frameborder="0" loading="lazy"></iframe>

Add it to your stack

The embed is a plain iframe, so it works anywhere HTML works. Here's how it looks in a few common setups.

Plain HTML

HTML

<iframe
  src="https://howlonguntilx.com/embed/widget?event=christmas&theme=light"
  width="300"
  height="160"
  frameborder="0"
  loading="lazy"
></iframe>

React / Next.js

JSX

export function ChristmasCountdown() {
  return (
    <iframe
      src="https://howlonguntilx.com/embed/widget?event=christmas&theme=dark"
      width={300}
      height={160}
      style={{ border: 'none', borderRadius: 14 }}
      loading="lazy"
      title="Countdown to Christmas"
    />
  );
}

WordPress

Add a Custom HTML block to any post or page and paste the plain HTML snippet above.

Webflow / Squarespace / other site builders

Look for an Embed or Custom Code element, drop it where you want the widget, and paste the plain HTML snippet inside it.

Customization options

`event`	string	Same resolution rules as the Countdown API — a tracked slug (e.g. `christmas`) or a free-text date (e.g. `2027-06-01`).
`theme`	"light" \| "dark"	Defaults to light. Set to match your site's own theme.
`width / height`	iframe attributes	300×160 is the tuned default. The widget is responsive down to ~220px wide if you need it smaller.

The widget ticks live via client-side JavaScript inside the iframe — you don't need to refresh or re-render anything on your end.

Need raw data instead of a visual widget?

Use the JSON API directly to build fully custom countdown UI in your own app.

View API docs →

Questions, or need a custom size/theme? Get in touch.