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

# Leaderboards explained

How Leaderboards work in InHouseQueue

## How does the leaderboard work?

By default, completed matches are tracked by the :globe\_with\_meridians: <mark style="color:purple;">Global Leaderboard</mark>. Think of this as your "main" leaderboard.

When you create a [**new** queue](/docs/quick-start/create-more-queues.md), by default, games played in that queue count towards the :globe\_with\_meridians:<mark style="color:purple;">Global Leaderboard</mark>.

Continue reading to learn how to create a new queue with its unique leaderboard.

<div align="left"><figure><img src="https://1130318129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwcHfLjgS9hMDSoOpDEDo%2Fuploads%2FFWonc7sTYZR2d3BsyhCu%2Fglobal_leaderboard.png?alt=media&amp;token=0d168b9d-d674-4f4a-b98f-089f8de1e59c" alt=""><figcaption><p>You can recognise global leaderboard queues by the footer message.</p></figcaption></figure></div>

### The quick way: use the Manage Queue button

The fastest way to give a queue its own leaderboard is directly from the queue message itself - no command needed.

1. First you must follow the instructions from [Create More Queues](/docs/quick-start/create-more-queues.md) if you haven't already. You should have at least **2** queues at this point.
2. Click the **⚙️ Manage Queue** button on the queue you want to give its own leaderboard. This button sits next to Leave Queue, and only works for admins (or anyone granted `manage_channels`/the relevant permission).

<div align="left"><figure><img src="https://1130318129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwcHfLjgS9hMDSoOpDEDo%2Fuploads%2Fgit-blob-fe781734f142d84fb6ff7f3bc8d8d42537897454%2Funique_queue_1.png?alt=media" alt=""><figcaption><p>The Manage Queue button on the queue message.</p></figcaption></figure></div>

3. Click **Make Leaderboard Unique** in the panel that opens.

<div align="left"><figure><img src="https://1130318129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwcHfLjgS9hMDSoOpDEDo%2Fuploads%2Fgit-blob-e0cc4420bcb9f64d4497c4348f8e37838b766279%2Fchange_game_mode.png?alt=media" alt=""><figcaption></figcaption></figure></div>

That's it - a leaderboard channel is created for this queue automatically.

{% hint style="info" %}
Prefer using a command instead? Keep reading below for the `/queue set_unique_leaderboard` walkthrough.
{% endhint %}

***

### Creating a unique leaderboard

1. First you must follow the instructions from [Create More Queues](/docs/quick-start/create-more-queues.md) if you haven't already. You should have at least **2** queues at this point. Both should say :globe\_with\_meridians: <mark style="color:blue;">Global Leaderboard</mark> in the footer.
2. Activate a unique leaderboard by running `/queue set_unique_leaderboard` and selecting one of the queues you created earlier. For this example, we will pick <mark style="color:blue;">#highelo-queue</mark>.

<div align="left"><figure><img src="https://1130318129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwcHfLjgS9hMDSoOpDEDo%2Fuploads%2FFhbyoiDTTSSjQrwNJ7A6%2Funique_lb2.png?alt=media&amp;token=cc727f2e-e7e3-4dc3-b6a4-f7e7be72ba6b" alt=""><figcaption></figcaption></figure></div>

You can also select the command hyperlink after a [Basic Setup](/docs/quick-start.md)

<figure><img src="https://1130318129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwcHfLjgS9hMDSoOpDEDo%2Fuploads%2FYQQcxrNh8zyAAyc5KyOF%2Funique_lb-1.png?alt=media&amp;token=6d3011d7-1e20-40ad-ac7d-501f6df3073d" alt=""><figcaption><p>I have created 2 queues. One for low elo, and one for high elo</p></figcaption></figure>

3. Hit Enter. A leaderboard channel will now be created for <mark style="color:blue;">#highelo-queue</mark>.

<figure><img src="https://1130318129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwcHfLjgS9hMDSoOpDEDo%2Fuploads%2FKor44TaLo34vMrmzkppL%2Funique_lb-3.png?alt=media&amp;token=3d1bc5d1-c506-41fd-8e40-83525ba1df8d" alt=""><figcaption></figcaption></figure>

4. Games played in <mark style="color:red;">#highelo-queue</mark> will update the <mark style="color:red;">#highelo-queue-top10</mark> leaderboard.

<figure><img src="https://1130318129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwcHfLjgS9hMDSoOpDEDo%2Fuploads%2F7EIUq3N4wMpry9Jqdi7O%2Funique_lb-4.png?alt=media&amp;token=07c81402-1c24-42a0-8f71-682c9943daae" alt=""><figcaption><p>High Elo Queue is Unique</p></figcaption></figure>

5. Games in the <mark style="color:green;">#lowelo-queue</mark> will update the <mark style="color:green;">#top-10</mark> leaderboard. This is the default leaderboard.

<figure><img src="https://1130318129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwcHfLjgS9hMDSoOpDEDo%2Fuploads%2Frak2ZKLyd72a4iBeiB5k%2Funique_lb-5.png?alt=media&amp;token=4bb9e9f3-4302-4156-9778-d4b264589f8e" alt=""><figcaption><p>Low Elo Queue is Global</p></figcaption></figure>

### All done.

This queue is now entirely independent. This is useful for separating a high-skill queue from a lower-skill queue — or for a separate casual queue during your [InHouseQueue Seasons](/docs/features/inhousequeue-seasons.md).

You can use Discord channel permissions to make queues visible only to players with a specific role.

***

#### Commands that need the queue channel parameter

Certain commands, such as `/leaderboard` and `/rank` have an optional parameter for selecting the queue channel. Once selected, you'll see the leaderboard or rank for the selected queue.

<div align="left"><figure><img src="https://1130318129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwcHfLjgS9hMDSoOpDEDo%2Fuploads%2FKGgw3xH8OYSGOiPiTYgG%2Fhigh%20elo%20queue.png?alt=media&amp;token=79f24be0-8716-4cb0-a0c7-de7664b24272" alt=""><figcaption><p>If you don't enter a <code>queue_channel</code>, it will default to Global Leaderboard</p></figcaption></figure></div>

{% hint style="info" %}
As of writing our Website leaderboard [https://inhousequeue.xyz/leaderboard/](https://inhousequeue.xyz/leaderboard/1112808150966485126)<mark style="color:blue;">\<SERVREID></mark> will only show scores from the Global Leaderboard.
{% endhint %}

{% hint style="danger" %}
Don't delete your unique leaderboard unless you're sure you no longer need it. You will lose all stats recorded in that queue.

The Global Leaderboard is never affected.
{% endhint %}
