Configure Game Center

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 100 leaderboard sets, and a set can have a maximum of 100 leaderboards.

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.

To view how your leaderboard sets are organized and their leaderboard’s archived status, click on View Leaderboards in Leaderboard Sets. The page that appears lists leaderboards by Reference Name and Leaderboard ID, and also includes checkmarks to specify which sets your leaderboards belong to.

Merge leaderboards into sets

  1. From My Apps, select your app.

  2. In the toolbar, click Services. The page opens with the Game Center tab selected.

  3. In the Leaderboards section from the More menu, select Move All Leaderboards into Leaderboard Sets.

    Merge leaderboards into sets screenshot
  4. Enter the leaderboard set reference name and leaderboard set ID, then click Continue.

  5. Click Add to Leaderboard Set to select which leaderboards you would like to include in the set.

  6. 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

  1. From My Apps, select your app.

  2. In the toolbar, click Services. The page opens with the Game Center tab selected.

  3. In the Leaderboard Sets section, click the add button (+).

  4. Enter the leaderboard set reference name and leaderboard set ID, then click Continue.

  5. Under Leaderboards in This Set, click Add to Leaderboard Set. You must add at least one leaderboard to the set.

  6. Select a leaderboard, add a Display name in desired languages, then click Save.

    To add additional leaderboards to the set, repeat steps 5 and 6.

    Add a new leaderboard set
  7. Click Add Language under Leaderboard Set Localization to add one or more languages to your leaderboard set. You must add at least one language.

  8. Enter the required information:

    • In the dialog that appears, choose a language from the Language menu.

    • In the Display Name field, enter a localized display name for this leaderboard set as you would like it to appear in Game Center.

    • Optionally, you can click Choose File to add a localized image for your leaderboard.

    • Click Save. To add additional language support for your leaderboards, repeat the above steps for each language.

  9. Click Save.

Add a new leaderboard to a set

  1. From My Apps , select your app.

  2. In the toolbar, click Services. The page opens with the Game Center tab selected.

  3. In the Leaderboard section, click the add button (+).

  4. Choose which leaderboard type you'd like to add to your set, then complete the leaderboard configuration using the steps in Configure leaderboards.

  5. Under Leaderboard Sets, click Add to a Leaderboard Set.

    Note: To complete your leaderboard creation, it must be added to an existing leaderboard set.

  6. Choose the leaderboard set to contain your leaderboard, add one or more languages, then click Save.

    Add new leaderboard to a set
  7. Add a language in the Leaderboard Localization section by clicking Add Language.

  8. Enter the required information:

    • In the dialog that appears, choose a language from the Language menu.

    • In the Name field, enter a localized reference name for the leaderboard.

    • Choose a localized score format from the Score Format menu.

    • Enter the singular and plural version of your score format suffix. If Score Format Suffix Plural doesn’t appear, it’s not needed for the selected language. Additionally, if you want a space to appear between the score and the suffix, you can enter a space followed by the suffix text.

    • Optionally, you can click Choose File to add a localized image for your leaderboard.

    • Click Save.

      To add additional language support for your leaderboards, repeat the steps above for each language.

  9. Click Save.

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.

  1. From My Apps, select your app.

  2. In the toolbar, click Services. The page opens with the Game Center tab selected.

  3. From the Leaderboard Sets section, hold the pointer over the leaderboard you want to delete, then click the Delete button as highlighted in the screenshot below:

    Delete leaderboard set
  4. 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.

Remove all leaderboards from sets

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.