Embed Widget
Add a live countdown timer to any website with a single line of HTML.
No backend needed. No signup required for basic embeds. Copy the iframe code and paste it into your site — works with WordPress, Webflow, Squarespace, Notion, or any platform that accepts HTML.
Widget Types
Event Countdown
Count down to a specific date and time. Shows days, hours, minutes, seconds.
Product launches, event registration pages, holiday countdowns.
?type=event&title=Launch&date=2026-12-31T00:00:00ZDuration Timer
Count down from a fixed duration. Alarm sounds at zero.
Meeting timers, classroom activities, workout intervals, pomodoro sessions.
?type=countdown&duration=1500&title=Focus+SessionInterval Timer
Alternating work and rest periods that loop automatically.
HIIT workouts, Tabata training, structured classroom sessions.
?type=interval&work=45&rest=15&rounds=8URL Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
| type | enum | countdown | countdown, event, interval |
| title | string | — | Display title above the timer |
| duration | integer | — | Seconds (for countdown type) |
| date | ISO8601 | — | Target datetime (for event type) |
| work | integer | — | Work interval in seconds (interval type) |
| rest | integer | — | Rest interval in seconds (interval type) |
| rounds | integer | — | Number of cycles (interval type) |
| theme | enum | light | light, dark, auto |
| color | hex | 6C63FF | Primary color without # |
| lang | string | en | en, zh, ja, es, fr, de, ko |
| show_title | boolean | 1 | Show/hide the title |
| show_date | boolean | 1 | Show target date (event type only) |
| show_brand | boolean | 1 | Show Castimer branding (0 = Pro only) |
| tz | string | UTC | Timezone (IANA format, e.g. Asia/Taipei) |
| alarm | boolean | 1 | Play alarm sound at zero |
Embed Generator
Configure your widget below and copy the generated code.
Looking for a more visual experience? Try our standalone Embed Generator Tool with live preview and advanced options.
#6C63FFLive Preview
<iframe
src="/widget?type=countdown&duration=300&theme=light&color=6C63FF&lang=en&show_brand=1"
style="width:100%;max-width:400px;height:400px;border:none;border-radius:12px;"
title="Castimer Widget"
loading="lazy"
></iframe>Customization
Themes
Three built-in themes. Set via the theme parameter.
Custom Colors
<!-- Purple primary color -->
<iframe src="/widget?type=countdown&duration=300&color=6C63FF" ...></iframe>
<!-- Teal primary color -->
<iframe src="/widget?type=countdown&duration=300&color=1D9E75" ...></iframe>Hide Branding (Pro)
Set show_brand=0 to remove the Castimer watermark. Requires a Pro or Enterprise plan.
<iframe src="/widget?type=countdown&duration=300&show_brand=0" ...></iframe>Examples
5 Minute Meeting Timer
<iframe
src="/widget?type=countdown&duration=300&title=Meeting+Timer&theme=light"
style="width:100%;max-width:360px;height:360px;border:none;"
title="5 Minute Meeting Timer"
></iframe>Christmas Countdown
<iframe
src="/widget?type=event&title=Christmas&date=2026-12-25T00:00:00Z&tz=America/New_York&theme=dark"
style="width:100%;max-width:360px;height:360px;border:none;"
title="Christmas Countdown"
></iframe>Tabata Interval Timer
<iframe
src="/widget?type=interval&work=20&rest=10&rounds=8&title=Tabata&theme=light"
style="width:100%;max-width:360px;height:360px;border:none;"
title="Tabata Timer"
></iframe>