Tags & status badges
Tags
Tags group related monitors — by service, environment, team, or however you think about your jobs. Add tags like production, billing, or backups to a monitor, then filter the dashboard by tag, status, or by name to see just the slice you care about.
Tags also drive rollup status badges, below.
Status badges
A status badge is a small live image you can embed anywhere that renders an image — a README, a status page, an internal wiki. It reflects the current state of a monitor (or a group of them) without anyone logging in.
Badges come in two forms:
- Per monitor — the state of a single monitor.
- Rollup by tag — the worst state across every monitor carrying a tag. If any
backupsmonitor is down, thebackupsbadge shows down. This gives you one badge for a whole service.
Because the rollup reports the worst state, a badge shows degraded distinctly — not just up or down — so a warning-level problem is visible at a glance.
Badges are available as an SVG image (to embed) and as JSON (to drive your own status page):

The badge key is separate from your check-in and API keys, so publishing a badge never exposes anything that can change a monitor.