VoiceStatsDocs

Web Leaderboard

Web Leaderboard gives your server a dedicated page for its voice and message rankings. Every server with VoiceStats has a leaderboard page at:

https://voicestats.xyz/leaderboard/<server-id>

Settings are managed from Modules → Web Leaderboard in the VoiceStats Dashboard.

What the Page Shows

Visitors can switch between Voice and Messages rankings and choose one of the following time periods:

  • All time
  • 30 days
  • 7 days
  • 1 day

Each ranking lists the top 10 members with their display name, avatar, position, and activity value. The leaderboard data refreshes every 5 minutes.

Your Stats

Members who sign in with Discord can see their own rank and activity value alongside the leaderboard. Visitors who are not signed in are shown an option to sign in.

Personal Card Color

Every signed-in member can choose the color used on their own Web Leaderboard cards. Open the account menu in the top-right corner, select Profile, choose a color under Web Leaderboard card, and save.

This setting is free and applies whenever that member appears on a public or private Web Leaderboard. It does not change other members' cards.

See Profile Appearance for more information.

Voice Time Format

Voice durations use the server's selected Settings → Time Units format. Changing this setting updates how voice values are written on the Web Leaderboard; it does not change recorded activity.

Role Rewards

If the server has voice or message role rewards configured, they are displayed on the leaderboard page so visitors can see the available milestones.

Leaderboard Access

The leaderboard is public by default — anyone with the link can view it without signing in.

Turn on Make leaderboard private to restrict access. When the leaderboard is private, only people who can access the server's dashboard can view it. A visitor who is not signed in is redirected to Discord login and returned to the leaderboard afterward.

You can switch between public and private at any time without changing the leaderboard address.

Custom Banner

Premium servers can replace the default server banner with a custom image URL. Enter an HTTPS image URL in the Banner image URL field. Leave it empty to use the Discord server banner.

This custom URL changes the banner on the Web Leaderboard webpage only. The preset backgrounds used in images generated by the bot are managed separately under Banners.