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

# Guild Leaderboards

Guild Leaderboards rank members of a specific Discord server (a "guild") against each other. They make it easy to see who's the best player in your community without comparing yourself against the entire global player base.

Find them under **Leaderboards → Guilds**, or directly from any guild's page.

## Guild Member Leaderboards

Each guild has its own leaderboards covering only its members. This includes:

* **Total points** — same scoring as the global leaderboard, but only ranking guild members.
* **Platform-specific** — Steam, PSN, Xbox, Riot, Battle.net rankings within the guild.
* **Contest wins** — most Contests won by guild members.
* **Gem earnings** — total gems earned by guild members (from wins, daily claims, reward programs).

You'll only see this for guilds you're a member of — guild leaderboards are private to members.

## Guild vs. Guild Leaderboards

RivalRyze also ranks **guilds against each other** based on aggregate member activity. Find this at **Leaderboards → Guilds → Global Guild Rankings**.

Guild-vs-guild scoring is based on:

* **Aggregate member points** — the sum of all members' total points.
* **Average member rank** — the mean global rank of members (rewards quality, not just quantity).
* **Contests hosted and won** — guild activity in competitive events.
* **Member count** — larger guilds have more potential but also more variance.

This produces a leaderboard of the most active and competitive Discord communities on RivalRyze.

## Why guild leaderboards matter

For guild admins and members:

* **Community engagement.** Members compete with each other in a friendly way.
* **Bragging rights.** Being the top player in a 500-member Discord is meaningful.
* **Guild reputation.** Your guild's rank attracts new members and signals competitiveness.

## Switching the active guild

If you're a member of multiple guilds, you can set one as your **active guild** — this affects:

* Which guild's leaderboard appears as your "primary" view.
* Which Discord server appears alongside your username on the global leaderboard.
* Which guild's notifications take priority.

You can change your active guild any time:

* **On the website:** Profile → Active Guild.
* **In Discord:** use the `/set-active-guild` command.

## Filtering guild leaderboards

Each guild leaderboard supports:

* Time window (all time / season / month / week)
* Per-platform filtering
* Sort by Contests won, gems earned, or total points

## How often guild leaderboards update

Guild leaderboards reflect each member's individual sync schedule:

* A Pro member's data refreshes every 30 minutes.
* A Free member's data refreshes every 4 hours.

The leaderboard itself recomputes continuously from the latest available data.

## Guild leaderboard fairness

A few notes on how guild rankings work:

* **Members count whether or not they're active on RivalRyze.** A Discord member who has joined RivalRyze and linked their Discord shows up. A member who hasn't linked doesn't.
* **Multi-guild members count for every guild they're in.** Your points contribute to every guild leaderboard you appear on.
* **Leaving a guild removes you from its leaderboard immediately.**

## For Guild Admins

If you run a Discord server with the RivalRyze Bot installed, you have additional options:

* **Pin the leaderboard to a channel.** The bot will post the current leaderboard daily / weekly. See [Guild Settings & Activity Feed](/for-guild-admins/guild-settings.md).
* **Use `/leaderboard` in any channel** to fetch a current ranking on demand.
* **Use `/gem-leaderboard`** specifically for the gem earnings leaderboard.

See [Bot Commands Reference](/for-guild-admins/bot-commands-reference.md) for all leaderboard-related commands.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.rivalryze.com/leaderboards/guild-leaderboards.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
