App Store Connect Help
Manage leaderboards
Leaderboards help encourage friendly competition within your game. When you configure leaderboards in App Store Connect, you specify details such as the scores to collect and how to order them. For each language you want a leaderboard to display in, you specify the leaderboard name, score format, and score unit. You can also include a localized image to illustrate the score in the leaderboard.
There are two types of leaderboards that can be created:
-
Classic leaderboards: A leaderboard where score data will never reset unless the leaderboard is deleted.
-
Recurring leaderboards: A leaderboard where score data will continually be reset based on set preferences.
You can have up to 100 leaderboards without using leaderboard sets. When you use leaderboard sets, you can have up to 500 leaderboards across 100 leaderboard sets.
For development information, visit Leaderboards in GameKit.
Required role: Account Holder, Admin, App Manager, Developer, or Marketing. View role permissions.
Create a classic leaderboard
-
In Apps, select the app you wish to enable for Game Center.
-
In the sidebar, click Game Center.
-
Click Add Leaderboard.
Note: If a leaderboard already exists, click the add button (+) in the Leaderboards section. If a leaderboard set already exists, either create a new leaderboard set or select a set and add your new leaderboard to that set.
-
Enter the reference name and leaderboard ID.
-
Select Classic Leaderboard.
-
Click Next.
-
Enter the score format information.
-
Click Create.
-
Under Leaderboard Localization, add one or more languages by clicking Add Localization.
-
Enter the localization information.
-
Click Save.
To add additional language support for your leaderboards, repeat the above steps for each language. If you're ready to publish the leaderboard, add it to an app version.
Create a recurring leaderboard
Recurring leaderboards add flexibility to your leaderboard configuration by allowing you to reset your leaderboards’ scores. The ability to reset your leaderboards creates a more competitive gaming experience, as it allows players to set a new top score for each leaderboard recurrence.
Leaderboards have a minimum recurrence of five minutes, a maximum recurrence of 30 days, and aren't allowed to overlap.
-
In Apps, select the app you want to view.
-
In the sidebar, click Game Center.
-
Click Add Leaderboard.
Note: If a leaderboard already exists, click the add button (+) in the Leaderboards section. If a leaderboard set already exists, either create a new leaderboard set or select a set and add your new leaderboard to that set.
-
Enter the reference name and leaderboard ID.
-
Click Next.
-
Select Recurring Leaderboard.
-
Complete the Start Date and Time, Duration, and Restarts Interval fields.
-
Click Next.
-
Enter the score format information.
-
Click Create.
-
Under Leaderboard Localization, add one or more languages by clicking Add Localization.
-
Enter the localization information.
-
Click Save.
To add additional language support for your leaderboards, repeat the above steps for each language. If you're ready to publish the achievement, add it to an app version.
Set a default leaderboard
-
In Apps, select the app you want to view.
-
In the sidebar, click Game Center.
-
Locate the Default column in the Leaderboards section, then hold the pointer over the leaderboard you'd like to set as default.
-
Click Make Default.
Arrange leaderboards
Leaderboards are presented to players in the order they appear in App Store Connect. You can change the order of the leaderboards on the app’s Game Center page.
-
In Apps, select the app you want to view.
-
In the sidebar, click Game Center.
-
Click Edit Order on top right.
To arrange your leaderboards within a leaderboard set, select the leaderboard set that you want to view and click Edit Order.
-
Click the reordering control on the left side of the Leaderboards row and drag it to a new position.
-
Click Save.
Archive or unarchive a leaderboard
You can archive live leaderboards to remove them from all relevant sections of Game Center’s user interface. This also ensures they won’t return when retrieving a GKLeaderboard. You can archive and unarchive leaderboards at any time.
-
In Apps, select the app that you want to manage.
-
In the sidebar, click Game Center.
-
In the Leaderboards section, select the leaderboard that you want to archive.
If leaderboard sets exist, select the leaderboard set that you want to view and select the leaderboard that you want to archive.
-
Click Archive Leaderboard.
If the leaderboard is already archived, the Unarchive Leaderboard option will be displayed. Click it and follow the prompt to unarchive it.
-
Click Archive.
It may take over an hour for the changes to take effect to the players.
To view the list of archived leaderboards, click the ellipsis menu (…) within the Leaderboards section, and select View archived leaderboard. If there are Leaderboard Sets, select the set you want to view first.
Learn how to set default leaderboard in App Store Connect or GameKit.
Delete a leaderboard
The status of a leaderboard is displayed in the Status column of the Leaderboards table. The possible status values are described in Leaderboard Statuses. A Delete button appears in this column when a leaderboard is eligible for deletion. After a leaderboard is available in Game Center, it can’t be deleted.
-
In Apps, select the app you want to view.
-
In the sidebar, click Game Center.
-
In the Leaderboard section, hold the pointer over the leaderboard you want to delete, then click the delete button.
-
Click Delete.
Optionally, you can delete a leaderboard by selecting one from the Leaderboard section and clicking Delete this leaderboard on bottom left.