Documentation

​
​

Development

User Acquisition

Monetization

Industry

Leaderboards

Unity SDK

Admin API

Client API

Open Unity Dashboard

Leaderboards

LiveOps
​
​
Leaderboards
  • Overview
  • Get started
  • Concepts
    • Sort order
    • Update strategies
    • Tiers
    • Buckets
    • Resets
    • Archives
    • Metadata
    • Leaderboard assets
  • Tutorials
  • Reference
  • Privacy and consent
  1. Leaderboards

Resets

Understand how to clear leaderboard scores manually or on a scheduled basis.
Read time 1 minute
Last updated 8 months ago

You can configure leaderboards to reset automatically on a predefined schedule or you can reset them manually. Resetting a leaderboard clears out all of the current scores.
When resetting a leaderboard 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 archives page for details on archives.

Manual resets

To reset leaderboards in the Unity Dashboard, select the leaderboard and select Reset Leaderboard. You can also reset leaderboards using the CLI and by using the Admin API.
When resetting a leaderboard from the Unity Dashboard, you can optionally create an archive of the scores before you reset the leaderboard.

Scheduled resets

You can configure a scheduled reset to be a recurring reset or a one time reset.
If you configure a scheduled recurring reset, scores contained in the leaderboard will expire based on this schedule and users will be able to submit new scores for each reset cycle.
Note
For recurring leaderboard resets, the first reset occurs on the date specified in the
Start
key. After this, the leaderboard resets according to the schedule specified in the
Schedule
key.
For advanced configuration options for scheduled resets, for example using
@every 72h
to reset a leaderboard every 3 days, refer to the documentation for
resetConfig
in the Admin API or the Leaderboards assets example.
As with manual resets you can configure leaderboards to automatically create an archive on reset.

Copyright © 2026 Unity Technologies
LegalPrivacy PolicyCookiesDocumentation Terms of UseDo Not Sell or Share My Personal InformationYour Privacy Choices (Cookie Settings)

"Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S and elsewhere (more info here). Other names or brands are trademarks of their respective owners.

Some pages are machine-translated for convenience, and may contain inaccuracies. In the event of conflicting information, the English version is authoritative.

  • On this page
    • Manual resets

    • Scheduled resets


Report a problem with this page