Badge Configuration
Customize the output parameters, layout, and colors. Copy the generated snippet straight into your repository's README.
Advanced Integrations
Go beyond static images. Embed a live-updating action button on your site, or consume pure JSON data from the CORS-enabled API.
Badge Styles
Generated dynamically from the API to fit your theme. Fully compatible with Shields.io styles.
Made for Developers
Real-Time Counts
Automatically refreshed member metrics served with smart cache headers to maximize delivery speed.
Deep Customization
Personalize colors, label strings, style shapes, and logo visibility directly inside the generator UI.
Zero Configuration
No backend SDK imports required. Insert query values into a single image URL and drop it in.
Cloud-Native Edge
Runs on both Vercel and Cloudflare Pages/Workers, deploying at the edge for optimal response times.
Groups & Channels
Supports broadcast channels (showing subscribers) and groups (showing members + online users).
100% Free & Open
MIT Licensed code. Self-host your own instance or use the public deployment free of limits.
Query Parameter Options
| Parameter | Description | Default |
|---|---|---|
channelId |
Chat username (@name) or numeric ID for private chats |
— |
style |
flat · plastic · flat-square · for-the-badge · social | flat |
label |
Left-side label text | Telegram |
color |
Message background, hex without # |
2AABEE |
labelColor |
Label background, hex without # |
555555 |
logo |
Show the Telegram logo | true |
showOnline |
Append online member counts to the badge (public groups only) | false |
format |
Response format. Set to json to retrieve raw data. |
— |