Skip to content

Badges

Shardlens can serve public SVG badges with a headline number. Every badge is off until you switch it on.

Badge URL Shows
Servers /v1/badge/servers.svg Servers the bot is in
Monthly users /v1/badge/users-monthly.svg Unique users so far in the current salt period: this month, or this week or day if Settings rotates salts more often
Commands per day /v1/badge/commands-daily.svg Commands run in the last 24 hours (slash, context menu and prefix commands)

In the dashboard, Settings → Public badges, tick the badges you want and save. Then use the URL in Markdown:

![Servers](https://stats.example.com/v1/badge/servers.svg)

A badge that is switched off answers 404, so nothing is public by accident.

Badges are cached for 10 minutes on the collector and tell browsers and image proxies to cache for 10 minutes too. The endpoint is rate limited.