Embeddable badges

A live SVG badge showing your availability or any timezone's clock, ready to paste into a README, blog, or forum signature.

Embeddable badges

A badge is a small SVG image that shows whether you are free right now, and what time it is where you are. It updates itself wherever it is embedded, because the image is rendered fresh every time someone loads the page it sits on.

The Badges tab in your dashboard builds one visually and hands you the snippet. This page explains what the controls do and how to hand-edit a URL if you want to.

The two kinds

Your status
Your name, whether you are free, and your local clock. Reads your talk page, so keep that one public.
Any timezone
Just a clock for any IANA zone. No account needed and nothing personal in it.
Your status
https://whattime.link/u/maya

Pasting it somewhere

The dashboard gives you four ready-made formats. Pick the tab that matches where it is going.

[![maya on WhatTime.to](https://whattime.link/u/maya)](https://whattime.to/talk/maya)

Works in a GitHub readme, a profile, or any markdown file.

Customizing it

Every option is a query parameter, so you can tweak a URL by hand at any point.

Query parameters
style
flat | retro | terminal | minimaloptionaldefault: flat
The visual treatment.
size
normal | compactoptionaldefault: normal
normal is the classic 88x31 web button. compact is a thin auto-width pill that sits nicely in a README status line.
theme
dark | lightoptionaldefault: dark
Which ground the badge is drawn on. Pick the one that matches the page it lives on.
accent
hex coloroptional
Your own accent, as 3 or 6 hex digits with no #, for example accent=3db44a.
show
comma-separated listoptional
Which parts to include, from name, status, and time. A status badge shows all three by default; a timezone badge shows the name and the clock.
format
12h | 24hoptionaldefault: 12h
Whether the clock reads 3
PM or 15
.

Put together:

https://whattime.link/u/maya?style=terminal&size=compact&show=status,time&theme=light&accent=3db44a&format=24h

What the status word means

Badge saysBehind it
Free nowYou are inside an availability window.
Free soonYour next window opens within 90 minutes.
BusyYou are outside your windows right now.
AsleepOutside your windows, and it is the middle of the night where you are.
AwayNo upcoming availability in the next two weeks.
Not foundNo such username, or that talk page is set to private.

Good to know

  • It never renders as a broken image. An unknown username or a bad timezone still returns a valid SVG saying so.
  • It is cached for about a minute. That keeps embeds cheap without letting the badge drift meaningfully out of date.
  • Some readers do not refresh images. GitHub, for example, proxies and caches images aggressively, so a badge in a README can lag behind your real status.
  • The preview control is preview only. The "see it as" states in the dashboard exist so you can check your colors against every state. The badge you actually embed always follows your real schedule.