> For the complete documentation index, see [llms.txt](https://docs.voicestats.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.voicestats.xyz/dashboard/web-leaderboard.md).

# 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**

{% hint style="success" %}
All four Web Leaderboard periods, including **All time**, are available to Free and Premium servers.
{% endhint %}

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](/dashboard/profile.md) for more information.

## Voice Time Format

Voice durations use the server's selected [Settings → Time Units](/dashboard/settings.md#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.

{% hint style="info" %}
Custom Web Leaderboard banner is exclusive to Premium servers.
{% endhint %}

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](/dashboard/banners.md).