Leaderboard archives and versions
Archives
When resetting a leaderboard manually or using a scheduled reset, you can optionally create a read-only archive copy of the current leaderboard scores, which game clients can access by fetching scores for that archived version. Refer to the Leaderboards resets page for details on resets.
Archive limits
- Each leaderboard can have 10,000 archived versions.
- On exceeding the archive limit the oldest leaderboard archives are deleted on a first-in, first-out (FIFO) basis.
Important: When using leaderboard archives be mindful of your data retention policy and that each archived version leaderboards will count towards the number of leaderboards used per Monthly Active User.
Versions
Every leaderboard maintains a versionId to identify its current live version. It also maintains an array of versions for previous archived resets.
- Initial version: A
versionIdis generated automatically when you first create a leaderboard. - Version on reset: Each time a leaderboard is reset (manually or via a scheduled reset), the existing live version is archived under its current
versionId, and the system generates a newversionIdfor the newly live leaderboard. - Live vs. archived:
- Live version: Only the most recent version of a leaderboard (the live version) accepts new score submissions.
- Archived versions: All previous versions (created during resets) become read-only archives that you can query for historical data.
- Version identifiers:
versionIdis system-generated and cannot be customized. A validversionIdis a 23-character numeric string, for example:20250407151515238177311.
The versionId parameter in AddPlayerScore requests serves as a safeguard: it can be used to ensure that outdated game clients cannot inadvertently submit scores to a newer live leaderboard. You can only submit scores to the live leaderboard version.