> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PlayFab Leaderboards overview

> Overview of the PlayFab Leaderboards service: cross-platform rankings with multi-column tie-breaking, versioning, metadata rows, and statistic linking.

PlayFab Leaderboards is a cross-platform service that creates a sorted list of players with the purpose
of ranking them by scores. Leaderboards can be used as a standalone service or be linked with Statistics (so that updates to statistics feed into the entries on the leaderboard).

<img src="https://mintcdn.com/microsoft-4404708b/5IpvKlT-jmAaVkeY/images/playfab/community/leaderboards/leaderboards-relationship.png?fit=max&auto=format&n=5IpvKlT-jmAaVkeY&q=85&s=554aabf57b2d9d69b008e1b91162833d" alt="PlayFab Leaderboards Architecture" width="3236" height="2184" data-path="images/playfab/community/leaderboards/leaderboards-relationship.png" />

## Benefits

One of the main benefits of the new leaderboard service is the cross-platform capabilities and capacity of scaling up
to any needs. We're excited to introduce the following set of new features:

### Multicolumn (enhance) tie-breaking

This feature enables multiple scores per row that could be sorted with a given priority. With this sorting,
whenever there's a tie, we're able to determine which values take precedence and rank the corresponding player
higher on the leaderboard.

In the following example, we see a tie between Player C and Player B on Eliminations.
For ranking, we then use the next column as a tie-breaker, in this case, by Assists. The same logic applies for Player T and Player O, which goes further and uses Timestamp as the tie-breaker.

<img src="https://mintcdn.com/microsoft-4404708b/5IpvKlT-jmAaVkeY/images/playfab/community/leaderboards/tie-breaker-table.png?fit=max&auto=format&n=5IpvKlT-jmAaVkeY&q=85&s=f4184170a992549c700e33f2b8b7b671" alt="PlayFab Leaderboards Tie-breaking" width="859" height="358" data-path="images/playfab/community/leaderboards/tie-breaker-table.png" />

### Versioning

A leaderboard can have multiple versions of itself based on a reset strategy. Using this feature maintains
the definition of the leaderboard but resets the content and creates a new version of the leaderboard.
Older versions are still available for queries (updates are disallowed).

In this example, we can see how the definition of the leaderboard remains the same but the content
changes between each version.

<img src="https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/community/leaderboards/versioning-leaderboards.png?fit=max&auto=format&n=IwSYTY5BEqd_x-HK&q=85&s=0e4c6bbc43f8d0177a26f5f158dd7b34" alt="PlayFab Leaderboards Versioning" width="1243" height="403" data-path="images/playfab/community/leaderboards/versioning-leaderboards.png" />

### Metadata

This feature allows the options of setting custom information per row (check if this feature corresponds to your tier).

In this example, you can see how each row has its own metadata associated to it.

<img src="https://mintcdn.com/microsoft-4404708b/5IpvKlT-jmAaVkeY/images/playfab/community/leaderboards/metadata-leaderboards.png?fit=max&auto=format&n=5IpvKlT-jmAaVkeY&q=85&s=7c01fc870758cb76b0c08d013c63726d" alt="PlayFab Leaderboards Usage" width="826" height="421" data-path="images/playfab/community/leaderboards/metadata-leaderboards.png" />

### Standalone or linked to statistics

The Leaderboard can be linked to a Statistic definition, so that, whenever a
player hits a new personal record, it automatically gets pushed to the corresponding leaderboard of all players that are doing
long shots. A leaderboard can also be configured as a standalone component if your game already
has a Statistics engine doing the aggregation.

## See also

* [Quickstart leaderboards](/services/playfab/community/leaderboards/quickstart-leaderboards)
* [Create basic leaderboard](/services/playfab/community/leaderboards/create-basic-leaderboard)
* [Doing more with leaderboards](/services/playfab/community/leaderboards/doing-more-with-leaderboards)
* [Seasonal leaderboards](/services/playfab/community/leaderboards/seasonal-leaderboards)
* [Manual tiers](/services/playfab/community/leaderboards/manual-tiers)
* [Limits](/services/playfab/community/leaderboards/limits-leaderboards)
* [Ranking players by stats](/services/playfab/community/leaderboards/leaderboards-linked-to-stats)
* [Add contextual data to leaderboards](/services/playfab/community/leaderboards/metadata-leaderboards)
* [API reference](/services/playfab/community/leaderboards/api-reference)
* [Quota](/services/playfab/community/leaderboards/quota-leaderboards)
* [Leaderboard meters](/services/playfab/pricing/meters/leaderboard-meters)
* [Leaderboards and Cloudscript](/services/playfab/community/leaderboards/leaderboards-cloudscript).
* [Leaderboards With PlayStream and Telemetry](/services/playfab/community/leaderboards/leaderboards-with-playstream-and-telemetry)


## Related topics

- [PlayFab Leaderboards overview](/services/playfab/community/leaderboards/index.md)
- [PlayFab Statistics overview](/services/playfab/player-progression/statistics/index.md)
- [PlayFab for Unreal Engine Overview](/services/playfab/sdks/unified-unreal/overview.md)
- [PlayFab Community documentation](/services/playfab/community/index.md)
- [PlayFab Multiplayer Unity plugin overview](/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/multiplayer-unity-overview.md)
