Configure leaderboard sets

Leaderboard sets organize several leaderboards into a single unit. For example, in a game that includes many levels, you could define a leaderboard set to organize the leaderboards for each level. A single app can have up to 100 leaderboards. With leaderboard sets, a single app can have up to 500 leaderboards arranged across as many as 100 leaderboard sets.

You must have at least one leaderboard for your app before you can create a leaderboard set. After you add leaderboard sets to your app, all future leaderboards that you configure for the app must be included in a leaderboard set.

The process to start using leaderboard sets to organize your app’s leaderboards includes these steps:

Create the first leaderboard set.
Create additional leaderboard sets.
Add new leaderboards directly into leaderboard sets.

When you create the first leaderboard set, App Store Connect ensures that all existing leaderboards for the app are included in at least one leaderboard set.

Learn how to organize your leaderboards in leaderboard sets.

Learn how to view leaderboard’s archived status.

Required role: Account Holder, Admin, App Manager, Developer, or Marketing. View role permissions.

Merge leaderboards into sets

From Apps, select your app.
In the sidebar, click Game Center.
In the Leaderboards section, select Move Leaderboards Into Sets from the ellipsis menu (...).
Enter the Leaderboard Set Reference Name and Leaderboard Set ID, then click Continue.
Click Add to Leaderboard Set to select which leaderboards you would like to include in the set.
Enter the Display Name Localization, then click Save.
Under Leaderboard Set Localization, add one or more languages, then click Save.

You can add new leaderboard sets to your app to further customize how your leaderboards are displayed. Each set provides you with the ability to specify how a leaderboard is displayed within the set. You can put the same leaderboard into more than one set and configure a different display name for the leaderboard within each set.

Add a new leaderboard set

From Apps, select your app.
In the sidebar, click Game Center.
In the Leaderboard Sets section, click the add button (+).
Enter the leaderboard set reference name and leaderboard set ID, then click Create.

Note: You must add at least one leaderboard to the set.
Click Add Localization under Leaderboard Set Localization to add one or more languages to your leaderboard set. You must add at least one language.
Enter the required information:
- Language
- Display name: Localized display name for the leaderboard board set. This appears in Game Center.
- Localized image (optional)
Click Save.

To add additional language support for your leaderboards, repeat steps 7 and 8 for each language.

Add an existing leaderboard to a set

From Apps, select your app.
In the sidebar, click Game Center.
In the Leaderboard Sets section, select the leaderboard set you want to add your existing leaderboard to.
Click the add button(+) in the Leaderboards in Set, then select Add existing leaderboard.
Select the leaderboard you want to add.
Click Save.

Add a new leaderboard to a set

From Apps, select your app.
In the sidebar, click Game Center.
In the Leaderboard Sets section, select the leaderboard set you want to add your new leaderboard to.

Note: To complete your leaderboard creation, it must be added to an existing leaderboard set.
Click the add button(+) in the Leaderboards in Set, then select Add New Leaderboard.
Configure leaderboards.

Delete leaderboard sets

Before deleting a leaderboard set, you must ensure that all leaderboards within the set have been added to another set. Only after the leaderboards have been added to a new set can you delete an existing set.

From Apps, select your app.
In the sidebar, click Game Center.
From the Leaderboard Sets section, hold the pointer over the leaderboard set you want to delete, then click the Delete button.
Click Save.

If your app contains 100 or fewer leaderboards, you can click Remove All Leaderboards from Leaderboard Sets and all of your current leaderboard sets are deleted. To locate this option, navigate to the Leaderboards section and select the More menu.

Note: This option doesn’t appear for apps with more than 100 leaderboards. You must remove any excess leaderboards before you can use the Remove All Leaderboards from Leaderboard Sets button.

Optionally, you can delete a leaderboard set by selecting one from the Leaderboard set section and clicking Delete this leaderboard set on bottom left.