<!--
{
  "availability" : [
    "iOS: 7.0.0 -",
    "iPadOS: 7.0.0 -",
    "macCatalyst: 13.1.0 -",
    "macOS: 10.10.0 -",
    "tvOS: 9.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 3.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "GameKit",
  "identifier" : "/documentation/GameKit/GKLeaderboardSet",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "GameKit"
    ],
    "preciseIdentifier" : "c:objc(cs)GKLeaderboardSet"
  },
  "title" : "GKLeaderboardSet"
}
-->

# GKLeaderboardSet

Organizes leaderboards into logical and coherent groups.

```
class GKLeaderboardSet
```

## Overview

A [`GKLeaderboardSet`](/documentation/GameKit/GKLeaderboardSet) object represents a group of leaderboards that you configure in App Store Connect. For example, if your game has different worlds or levels, you can organize the leaderboards into sets for each world or level. In the Game Center dashboard, players navigate from the leaderboard sets to the individual leaderboards. If you use leaderboard sets, you must have one or more leaderboards and then place each leaderboard in a set, which can be a mix of classic and recurring leaderboards.

To load all the leaderboard sets for your game, use the [`loadLeaderboardSets(completionHandler:)`](/documentation/GameKit/GKLeaderboardSet/loadLeaderboardSets(completionHandler:)) class method. Then use the `title`, `identifier`, and `groupIdentifier` properties to access the data for each leaderboard set. If you localize the leaderboard set in App Store Connect, the `title` property localizes. GameKit only sets the `groupIdentifier` property when your game is in a game group. To load the images you add to App Store Connect for each set, use the [`loadImage(completionHandler:)`](/documentation/GameKit/GKLeaderboardSet/loadImage(completionHandler:)) method. Then use the [`loadLeaderboards(handler:)`](/documentation/GameKit/GKLeaderboardSet/loadLeaderboards(handler:)) method to get the leaderboards in each set.

To organize leaderboards into sets, see [Configure leaderboard sets](https://developer.apple.com/help/app-store-connect/configure-game-center/configure-leaderboard-sets) in App Store Connect Help.

## Topics

### Accessing Properties

[`title`](/documentation/GameKit/GKLeaderboardSet/title)

The localized title for the leaderboard set.

[`identifier`](/documentation/GameKit/GKLeaderboardSet/identifier)

The identifier for the leaderboard set.

[`groupIdentifier`](/documentation/GameKit/GKLeaderboardSet/groupIdentifier)

The identifier for the group that the leaderboard set belongs to.

### Loading Leaderboard Sets

[`-  loadImageWithCompletionHandler:`](/documentation/GameKit/GKLeaderboardSet/loadImage(completionHandler:))

Loads the localized image that you associate with the leaderboard set.

[`+  loadLeaderboardSetsWithCompletionHandler:`](/documentation/GameKit/GKLeaderboardSet/loadLeaderboardSets(completionHandler:))

Loads all of the leaderboard sets you configure for your game.

[`-  loadLeaderboardsWithHandler:`](/documentation/GameKit/GKLeaderboardSet/loadLeaderboards(handler:))

Loads the leaderboards in the leaderboard set.

[`-  loadLeaderboardsWithCompletionHandler:`](/documentation/GameKit/GKLeaderboardSet/loadLeaderboards(completionHandler:))

Loads all of the leaderboards for the current leaderboard set.

## Relationships

### Conforms To

[`Equatable`](/documentation/Swift/Equatable)

[`CustomStringConvertible`](/documentation/Swift/CustomStringConvertible)

[`Hashable`](/documentation/Swift/Hashable)

[`CustomDebugStringConvertible`](/documentation/Swift/CustomDebugStringConvertible)

[`NSCoding`](/documentation/Foundation/NSCoding)

[`NSObjectProtocol`](/documentation/ObjectiveC/NSObjectProtocol)

[`NSSecureCoding`](/documentation/Foundation/NSSecureCoding)

[`CVarArg`](/documentation/Swift/CVarArg)

### Inherits From

[`NSObject-swift.class`](/documentation/ObjectiveC/NSObject-swift.class)

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)