An object that organizes leaderboards into logical and coherent groups.


@interface GKLeaderboardSet : NSObject


A GKLeaderboardSet object is used to read data from a leaderboard set stored on Game Center. Your game uses GKLeaderboardSet objects when it wants to retrieve localized information about a specific leaderboard set or to retrieve scores from a leaderboard set. Typically, you do this when you want the data needed to implement your own custom leaderboard set user interface.

After incorporating leaderboard sets into your app, you must put all of your leaderboards into a set. Individual leaderboards can be put into multiple leaderboard sets and given different display names in each set.

During the development process, you create the leaderboard sets for your game in App Store Connect.

To retrieve information about the available leaderboards for the current set, use the loadLeaderboardsWithCompletionHandler: class method.

To retrieve information about the available leaderboard sets, use the loadLeaderboardSetsWithCompletionHandler: class method.

To retrieve information about the image associated with a leaderboard set, use the loadImageWithCompletionHandler: class method.


Loading the Leaderboard Sets

- loadImageWithCompletionHandler:

Load the image associated with the leaderboard set.

+ loadLeaderboardSetsWithCompletionHandler:

Load all of the leaderboard sets for the current game.

- loadLeaderboardsWithCompletionHandler:

Load all of the leaderboards for the current leaderboard set.


Localized title for the leaderboard set.


The identifier for the leaderboard set.


Identifies the group that the leaderboard set belongs to.


Inherits From

See Also



An object used to read data from a leaderboard stored on Game Center.


An object containing information for a score that was earned by the player.