# Leaderboards

InviteCount provides leaderboards for both invites and messages, allowing your community to compete and track their rankings.

***

## Viewing Leaderboards

| Command                        | Description                     |
| ------------------------------ | ------------------------------- |
| `/leaderboard invites [page]`  | Top inviters by total invites   |
| `/leaderboard bonus [page]`    | Top inviters by bonus invites   |
| `/leaderboard fakes [page]`    | Top inviters by fake invites    |
| `/leaderboard left [page]`     | Top inviters by left invites    |
| `/leaderboard regular [page]`  | Top inviters by regular invites |
| `/leaderboard messages [page]` | Top members by messages sent    |

Each page displays 10 members. Use the `page` parameter to browse further.

***

## :star2: Pinned Leaderboard

**Premium only.** Create an auto-updating leaderboard embed that refreshes every 15 minutes.

### Create a Pin

```
/leaderboard pin create [channel] [title] [description] [only_members]
```

| Parameter      | Default         | Description                               |
| -------------- | --------------- | ----------------------------------------- |
| `channel`      | Current channel | Channel where the pin will be posted      |
| `title`        | *(default)*     | Custom title for the embed                |
| `description`  | *(default)*     | Custom description for the embed          |
| `only_members` | `false`         | Only show members currently in the server |

### Update a Pin

```
/leaderboard pin update [title] [description] [only_members]
```

Updates the existing pin's settings and refreshes it immediately.

{% hint style="info" %}
The pinned leaderboard displays the **top 10 inviters** and updates automatically every 15 minutes. Only one pin per server is supported.
{% endhint %}

### Pin Embed Customization

The pinned leaderboard embed can be further customized via the [dashboard](https://invite-count.xyz/dashboard):

* Title, description, and color
* Footer text and icon
* Thumbnail and image
* Author name, icon, and URL

{% hint style="warning" %}
If your server loses premium status, the pinned leaderboard will be automatically deleted.
{% endhint %}

***

## Tips

* Use `/delete invites <@member>` to completely remove a member from the leaderboard.
* Use `/reset all invites` to reset everyone's invites to 0 without deleting the data.
* Leaderboards only show members who have data — new members with 0 invites won't appear until they get their first invite.