How to Make a Leaderboard in Discord: Step-by-Step Guide (2026)

Make a Discord leaderboard in a few minutes: add a leaderboard bot, run /leaderboard create, let members submit scores and pick how they get approved.

ScoreboardsNovember 13, 20269 min read
On this page11
  1. 01Step 1: Pick the kind of leaderboard you need
  2. 02Step 2: Add the leaderboard bot to your server
  3. 03Step 3: Run /leaderboard create
  4. 04Step 4: Let members submit their scores
  5. 05Step 5: Decide how scores get approved
  6. 06Step 6: Fine-tune it on the dashboard
  7. 07How to make a Discord leaderboard without a bot
  8. 08Keep members coming back to the leaderboard
  9. 09Troubleshooting
  10. 10FAQ
  11. 11Start your first leaderboard

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:

  1. 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.
  2. A leveling bot. Good if you only want to rank who chats the most. It cannot rank scores, times or matches.
  3. 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 typeHow a score counts
Points that add up over time (events, quizzes, wins)ClassicEvery approved score is added to the total
Each player's best score (arcade, bowling, trivia)HighscoreOnly a player's best result counts
Fastest completions (speedruns, races, puzzles)TimeLowest time wins, down to the millisecond
1v1 or team matches by skillELORatings move based on who beat whom
A season of matches with fixed pointsLeagueWin, draw and loss points (3/1/0 by default)
Art or photo contest entriesImage RatingMembers rate each entry from 1 to 10
Chat and voice activityLevels (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, or 00:00:000 with 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.

A live Discord leaderboard posted by the bot, with medals for the top three and Submit score, My rank and Web buttons

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.

A Discord score submission waiting for review with Approve and Reject buttons, next to an approved and a rejected submission

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.

Public web page for a Discord leaderboard on scoreboards.dev, and the same leaderboard embedded in light mode on a community 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.

A weekly Discord leaderboard recap with the top three and the biggest climber, and a season final card

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:

Still choosing a bot? The Discord leaderboard bot comparison puts Scoreboards next to five others.

Back to blogGuide · November 13, 2026

Free to start

Put a live leaderboard in your server

Invite the bot, run /leaderboard create, and your board is live in Discord and on the web in about a minute.