Skip to main content

​
Overview

Leaderboards show the top 10 most active members in your server, either by messages sent or by time spent in voice channels. This can be useful for rewarding your most active members. The leaderboard will automatically update every 10 minutes.
Leaderboards can be daily, weekly or monthly. Every leaderboard resets at midnight UTC, weekly leaderboards reset every Friday and monthly leaderboards reset on the 1st of each month.

​
Setting up a leaderboard

You can set up a leaderboard using the /automation leaderboard channel command.
You must have the Manage Server permission to use this command. bleed needs the View Channel, Send Messages and Embed Links permissions in the channel.

​
Customizing the message

You can customize the leaderboard message using the /automation leaderboard message command.
This command will open a Discord modal where you can enter your message. The message can be raw text, components or embeds with dynamic variables. If you no longer want a custom message, you can re-run the command and leave the modal empty.

​
Variables

Replace first with any rank up to tenth, like {user.third.mention}. The ranks are first, second, third, fourth, fifth, sixth, seventh, eighth, ninth and tenth.
Variables must be written exactly as shown. {user.three.name} and {user.first.messages_count} are not variables and will appear as raw text in the message.
If a rank has not been reached yet, its line will not be shown. For example, a leaderboard with 4 active members will only show 4 lines.
{last_reset} and {next_reset} can be used with Discord timestamps. For example, <t:{next_reset}:R> will display as in 3 days.
Every {guild.*} variable can be used as well, such as {guild.name}.

​
Changing the rank emotes

You can change the emote displayed next to a rank using the /automation leaderboard emote command.
Emotes are shared between the daily, weekly and monthly leaderboards of the same type. If you no longer want a custom emote, you can re-run the command without an emote.

​
Viewing the configuration

You can use the /automation leaderboard config command to view all of your server’s leaderboards. The buttons on this message allow you to change the channel, message and emotes of each leaderboard.
You can use the /automation leaderboard emotes command to change all 10 emotes at once. This command will open a Discord modal where you can enter one emote per line.
You can use the /automation leaderboard view command to privately preview a leaderboard.
If the leaderboard message was deleted, you can use the /automation leaderboard resend command to post it again.
You can use the /automation leaderboard remove command to remove a leaderboard.
This will also remove the leaderboard’s custom message.
You can use the /automation leaderboard variables command to view every variable inside of Discord.