Discord

Display live Discord server stats using the widget API or invite API.

Online count (branded)

Members (branded)

Online members

Online (outline)

Available badges

Quick examples

![online](https://shieldcn.dev/discord/1316199667142496307.svg)

![members](https://shieldcn.dev/discord/members/reactiflux.svg)

![online members](https://shieldcn.dev/discord/online-members/reactiflux.svg?variant=branded)

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

inviteCoderequired

Public invite code (not the full URL).

format

variant

size

theme

mode

logo

AutoUpload SVG

logoColor

—

label

flags

split

+Show color overrides

URLMarkdownHTMLrStAsciiDoc

![badge](https://shieldcn.dev/discord/members/reactiflux.png)

Execute

URL format

/discord/members/{inviteCode}.svg

Examples

Default variant

Branded (blurple)

Secondary variant

Outline variant

Copy-paste examples

How to get an invite code

1. Create or find a permanent invite link for your server
2. The invite code is the part after discord.gg/ — e.g., reactiflux from https://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

inviteCoderequired

Public invite code (not the full URL).

format

variant

size

theme

mode

logo

AutoUpload SVG

logoColor

—

label

flags

split

+Show color overrides

URLMarkdownHTMLrStAsciiDoc

![badge](https://shieldcn.dev/discord/online-members/reactiflux.png)

Execute

URL format

/discord/online-members/{inviteCode}.svg

Examples

Default variant

Branded (blurple)

Secondary variant

Outline variant

Copy-paste examples

When to use this vs widget API

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

serverIdrequired

Server must have widget enabled in Server Settings → Widget.

format

variant

size

theme

mode

logo

AutoUpload SVG

logoColor

—

label

flags

split

+Show color overrides

URLMarkdownHTMLrStAsciiDoc

![badge](https://shieldcn.dev/discord/1316199667142496307.png)

Execute

URL format

/discord/{serverId}.svg

Examples

Default variant

Branded (blurple)

Secondary variant

Outline variant

Copy-paste examples

How to find your server ID

1. Enable Developer Mode in Discord (User Settings → Advanced → Developer Mode)
2. Right-click your server name and click "Copy Server ID"

Requirements

The server must have the widget enabled:

1. Go to Server Settings → Widget
2. Enable "Enable Server Widget"