Leaderboards

InviteCount ranks your members by invites or messages. You can show a leaderboard with a command, pin one that updates itself, publish it on the web, or export it.

Show a leaderboard#

/leaderboard invites or /leaderboard messages, with these options:

Periods are calendar days in UTC, today included: day is today, week the last 7 days, month the last 30 days. Over a period, a member's count is the credited joins of that period whose member is still on the server (or the messages sent in that period).

Other rankings, all time only: /leaderboard bonus, /leaderboard fakes, /leaderboard left, /leaderboard regular.

The dashboard's Leaderboard page shows the same rankings, with each member's last invited member and retention (the share of their invited members still on the server). Members can also open the members' web page of the leaderboard, after logging in with Discord.

Hidden members are left out of every leaderboard. See Hidden members.

Pinned leaderboards (Premium)#

A pinned leaderboard is a message the bot posts in a channel, pins, and updates every 15 minutes.

From the dashboard:

1. Dashboard → Pinned leaderboards → New pinned leaderboard.
2. Choose the Channel, the Leaderboard (invites or messages) and the Period.
3. Optional: title, description, Members only (leave out members who left), colour, thumbnail, image, footer and author.
4. Click Post the leaderboard. It is posted at once.

With a command: /leaderboard pin create [channel] [title] [description] [only_members] [kind] [period].

Editing a pinned leaderboard updates its message at once. Deleting it stops the updates; the message stays in the channel. If someone deletes the message, the bot forgets that leaderboard.

Public web leaderboard (free; custom link Premium)#

Every server's leaderboard is on a web page that anyone can read without logging in, at https://invite-count.xyz/leaderboard/<server ID>. It is free and on by default; the View Online button of leaderboard messages opens it. Premium only adds a custom link, such as https://invite-count.xyz/leaderboard/<your-link>, which opens the same page.

From the dashboard:

1. Dashboard → Leaderboard → Public leaderboard.
2. Show the leaderboard on the web is on by default: turn it off to take the page down (nothing about your members is shown any more).
3. Optional: Show invite details (regular, bonus, left and fake invites, retention, last invited member).
4. Premium: choose a Custom link: 3 to 32 lowercase letters, digits or dashes, not only digits. Links are unique and first come, first served.
5. Click Save changes, then Copy the link.

With a command: /leaderboard publish [link] [show_details] puts the page back on the web (the link option is Premium) and /leaderboard unpublish takes it off.

What the page shows: the server's name, icon and member count, and for each member their display name, avatar and count. It never shows user IDs or usernames. Hidden members are left out, and members who left appear as Former member. Visitors can switch between invites, messages and levels (on servers that use levels) and between periods (this month on Premium servers).

Export a leaderboard (Premium)#

/export leaderboard [kind] [period] sends a CSV file: rank, member ID and counters. Up to 50,000 rows for a period. One leaderboard export every 5 minutes per server. Hidden members are left out.

/export csv (free) exports the raw invite counters of every member: member ID, invites, fakes, bonus, leaves.

Free and Premium#

Commands#

Full details: Leaderboard and stats commands.

Permissions#

Pinned leaderboards need View Channel, Send Messages, Embed Links and Read Message History in the channel, and Pin Messages to pin them.