A Discord leaderboard ranks your members by something they do: points, high scores, race times, match wins or chat activity. Discord has no general leaderboard feature of its own, so there are three ways to get one:
- A leaderboard bot. It posts the leaderboard in a channel, members submit their scores with a button and the board updates itself. This is what most servers use, and what this guide walks through.
- A leveling bot. Good if you only want to rank who chats the most. It cannot rank scores, times or matches.
- By hand. A pinned message or a shared spreadsheet that a moderator edits. Fine for one evening, tiring for a season.
The steps below use Scoreboards, a free Discord leaderboard bot. The Free plan includes every board type, 2 leaderboards per server and unlimited players, and the whole setup takes a few minutes.
Step 1: Pick the kind of leaderboard you need
Before you create anything, decide what the board counts. The type decides how a new score changes a player's rank, and it cannot be changed later without starting over.
| You want to rank… | Leaderboard type | How a score counts |
|---|---|---|
| Points that add up over time (events, quizzes, wins) | Classic | Every approved score is added to the total |
| Each player's best score (arcade, bowling, trivia) | Highscore | Only a player's best result counts |
| Fastest completions (speedruns, races, puzzles) | Time | Lowest time wins, down to the millisecond |
| 1v1 or team matches by skill | ELO | Ratings move based on who beat whom |
| A season of matches with fixed points | League | Win, draw and loss points (3/1/0 by default) |
| Art or photo contest entries | Image Rating | Members rate each entry from 1 to 10 |
| Chat and voice activity | Levels (beta) | XP from messages and voice, no submissions |
Not sure? Start with Classic. It fits most "who has the most points" servers, and each type has a guide of its own linked at the end.
Step 2: Add the leaderboard bot to your server
Invite Scoreboards and pick your server. You need Manage Server permission on that server to add a bot.
The invite asks for the permissions the bot needs to post a leaderboard: View Channel, Send Messages, Embed Links and Attach Files. If your server locks channels down per role, make sure the Scoreboards role has those four in the channel where the leaderboard will live.
Step 3: Run /leaderboard create
Go to the channel where the leaderboard should be posted and type /leaderboard create. A short form opens with three fields:
- Name: what members will see, like "Weekly Quiz" or "Mario Kart Times". Use spaces, not underscores.
- Leaderboard type: the one you picked in step 1.
- Log channel (optional): where submissions go for review before they count. More on that in step 5.
Press submit and the leaderboard is posted in the channel right away. Under the reply is a More options button for the settings that only some boards need:
- Sort order: descending puts the highest score on top, ascending the lowest. Time boards start ascending.
- Match format (ELO and League): 1v1, team matches up to 8v8, or a free-for-all of 3 to 8 players.
- Fixed teams (team formats): named teams sign up once and play as units.
Only server admins, members with Manage Server, or a bot permission role you choose on the dashboard can create leaderboards. Members can only submit.
Step 4: Let members submit their scores
The leaderboard message has buttons, and members use them without typing any commands:
- Submit score on Classic, Highscore and Time boards opens a form for the score and an optional screenshot as proof. Times are written as
00:00:00, or00:00:000with milliseconds. - Submit result on ELO and League boards records a match. The opponent gets a private thread to Confirm or Disagree, and the result counts on its own after 3 hours if nobody objects.
- Submit image on Image Rating boards takes the entry, a name and an optional description.
- My rank shows a member where they stand without scrolling.
- Web opens the full board in the browser.

Every approved score redraws the same message, so the board in the channel is always the current one. Nobody has to post a new leaderboard each week.
Admins can also enter scores for someone else: the Submit score form shows them a member picker, and /score sets or adjusts a player's score, rating or time directly. Players who are not on Discord can be added from the web board.
Step 5: Decide how scores get approved
This is the setting that decides whether your leaderboard can be trusted. There are three ways to run it:
- Instant. No log channel: every submission counts the moment it is sent. Best for small, friendly servers.
- Reviewed. With a log channel, every submission appears there as a card with the player, the score and the screenshot. Validators press Approve or Reject, and a rejection can say why.
- Timed auto-approval. Reviewed, but anything the validators have not handled after a set time approves itself. Set it on the dashboard.

For a competitive board with prizes, use a log channel and ask for a screenshot. For a casual one, start instant and add review the first time someone posts a suspicious number.
Step 6: Fine-tune it on the dashboard
Run /dashboard to open the leaderboard's settings in the browser. The settings worth a look on day one:
- Tier roles give a Discord role to the top ranks, so the leaders show in the member list. Tier roles are part of the Plus plan.
- Seasons freeze the final table on a date you pick, post a podium and start the next season on a fresh board. They can repeat weekly, every 2 weeks or monthly.
- Visible ranks set how many places each page of the board shows.
- CSV import brings in standings you already keep in a spreadsheet.
- Web page and embed: every public board has its own page on scoreboards.dev, and on the Premium plan one line of HTML puts it on your own website.

How to make a Discord leaderboard without a bot
You can, with some limits.
A pinned message. Post the standings, pin it and have a moderator edit it after each event. It costs nothing, but every update is manual and there is no history or proof.
A shared spreadsheet. Keep the scores in Google Sheets and link it in a channel. Sorting is automatic, but members leave Discord to see it and someone still types every score in.
Discord's own game leaderboards. Discord shows leaderboards for a few connected games and Activities, such as League of Legends. They only cover those games and you cannot add your own scores.
A leveling bot's /leaderboard. MEE6 and similar bots rank members by XP from chatting. That is an activity leaderboard, not a score leaderboard: it cannot count points, times or match results. If activity is all you need, Scoreboards' Levels (beta) board does that too.
If you are about to update a pinned message for the third time this week, it is time for a bot.
Keep members coming back to the leaderboard
A leaderboard nobody looks at is just a list. A few things keep one alive:
- Seasons. A fresh start every month gives new members a real chance at the top, and the frozen table is a record of who won.
- Weekly recaps. Every Monday, boards that saw play get a recap card with the top three and the biggest climber. Quiet boards are skipped.
- Roles for the top ranks. A visible role is worth more to most members than a number on a board.
- Proof. Asking for a screenshot costs players five seconds and saves arguments.
- A reward. A server currency members earn from their results and spend in a shop gives every score a use. The economy is part of the paid plans.

Troubleshooting
"I can't post a leaderboard in this channel." The bot is missing a permission there. Open Edit Channel, then Permissions, add the Scoreboards role and allow View Channel, Send Messages, Embed Links and Attach Files.
The leaderboard has no Submit button. An admin can turn it on in the dashboard under Leaderboard display, then Submit Button. Levels boards have no button on purpose: XP comes from chat.
Submissions never show up on the board. The board has a log channel, so they are waiting for review there. Approve them, or turn on timed auto-approval.
"A leaderboard with that name already exists." Use /leaderboard show to post the existing board in the current channel, or /leaderboard delete to remove it first.
FAQ
How do I make a leaderboard in Discord for free?
Add a leaderboard bot with a free plan. Scoreboards' Free plan covers every board type, 2 leaderboards per server and unlimited players. Run /leaderboard create, pick a type and the board is posted.
Can a Discord leaderboard update automatically?
Yes. With a bot, the leaderboard message is redrawn each time a score is approved. Levels boards update from chat and voice with no submissions at all.
Can a Discord leaderboard read game stats on its own?
Usually not. Few games share their stats with Discord bots, so members submit their scores, optionally with a screenshot, and moderators approve them. Discord's own leaderboards cover a handful of connected games only.
Who can create a leaderboard in my server?
Server admins, members with Manage Server, and anyone with the bot permission role you set on the dashboard. Everyone else can submit scores and check their rank.
Can I show my Discord leaderboard on a website?
Yes. Every public board has its own page on scoreboards.dev, on every plan. On the Premium plan the dashboard also gives you an embed code for your own site. See a working one on the embed demo.
Start your first leaderboard
Invite Scoreboards, run /leaderboard create and your Discord leaderboard is live in a minute. For a closer look at each type:
- Classic: points that add up over time
- High Score: only a player's best counts
- Fastest Times: speedruns, races and timed challenges
- ELO: skill ratings for 1v1 and team matches
- Art and photo contests: members rate each entry
- Levels (beta): XP from chat, voice, reactions and events, with role rewards, monthly races and houses
Still choosing a bot? The Discord leaderboard bot comparison puts Scoreboards next to five others.
