Discord
Badges for Discord servers — online count, member count, and more.
Display live Discord server stats using the widget API or invite API.
Online count (branded)
Members (branded)
Online members
Online (outline)
Available badges
| Badge | Endpoint | Description |
|---|---|---|
| Online Count | /discord/{serverId} | Live online members via widget API |
| Members | /discord/members/{inviteCode} | Total member count via invite API |
| Online Members | /discord/online-members/{inviteCode} | Online members via invite API |
Quick examples
Data sources
- Widget API — Requires server widget enabled in Server Settings → Widget
- Invite API — Uses public invite codes with
with_counts=true
No API key required. Cached 1 hour.
Endpoint details
Use these sections when you need the exact URL shape or a focused example for a specific badge type.
Discord Members
This section covers the discord/members badge endpoint.
Show the approximate total member count using a public invite code.
GET/discord/members/:inviteCode.svg
Path Parameters
required
Public invite code (not the full URL).
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/discord/members/reactiflux.svg?mode=dark"><img alt="badge" src="https://shieldcn.dev/discord/members/reactiflux.svg?mode=light"></picture>
URL format
/discord/members/{inviteCode}.svgExamples
Default variant
Branded (blurple)
Secondary variant
Outline variant
Copy-paste examples
Default — total member count via invite code
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/discord/members/reactiflux.svg?mode=dark"><img alt="discord members" src="https://shieldcn.dev/discord/members/reactiflux.svg?mode=light"></picture>Branded — Discord blurple background
How to get an invite code
- Create or find a permanent invite link for your server
- The invite code is the part after
discord.gg/— e.g.,reactifluxfromhttps://discord.gg/reactiflux
Discord Online Members
This section covers the discord/online-members badge endpoint.
Show the approximate online member count using a public invite code.
GET/discord/online-members/:inviteCode.svg
Path Parameters
required
Public invite code (not the full URL).
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/discord/online-members/reactiflux.svg?mode=dark"><img alt="badge" src="https://shieldcn.dev/discord/online-members/reactiflux.svg?mode=light"></picture>
URL format
/discord/online-members/{inviteCode}.svgExamples
Default variant
Branded (blurple)
Secondary variant
Outline variant
Copy-paste examples
Default — approximate online count via invite
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/discord/online-members/reactiflux.svg?mode=dark"><img alt="discord online members" src="https://shieldcn.dev/discord/online-members/reactiflux.svg?mode=light"></picture>Branded — Discord blurple background
When to use this vs widget API
| Method | Endpoint | Pros | Cons |
|---|---|---|---|
| Widget API | /discord/{serverId} | Exact count | Requires widget enabled |
| Invite API | /discord/online-members/{inviteCode} | No server config needed | Approximate count |
Discord Online Count
This section covers the discord/online badge endpoint.
Show how many members are currently online using the Discord widget API.
GET/discord/:serverId.svg
Path Parameters
required
Server must have widget enabled in Server Settings → Widget.
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/discord/1316199667142496307.svg?mode=dark"><img alt="badge" src="https://shieldcn.dev/discord/1316199667142496307.svg?mode=light"></picture>
URL format
/discord/{serverId}.svgExamples
Default variant
Branded (blurple)
Secondary variant
Outline variant
Copy-paste examples
Branded — Discord blurple background
How to find your server ID
- Enable Developer Mode in Discord (User Settings → Advanced → Developer Mode)
- Right-click your server name and click "Copy Server ID"
Requirements
The server must have the widget enabled:
- Go to Server Settings → Widget
- Enable "Enable Server Widget"