<!--
{
  "documentType" : "article",
  "framework" : "GameKit",
  "identifier" : "/documentation/GameKit/gkleaderboard-deprecated-symbols",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Deprecated symbols"
}
-->

# Deprecated symbols

Review unsupported symbols and their replacements.

## Topics

### Deprecated initializers

[`- (instancetype) init;`](/documentation/GameKit/GKLeaderboard/init)

Initializes a default leaderboard request.

[`init?(playerIDs: [String]?)`](/documentation/GameKit/GKLeaderboard/init(playerIDs:))

Initializes a leaderboard request to retrieve the scores of a specific group of players.

[`init(players: [GKPlayer])`](/documentation/GameKit/GKLeaderboard/init(players:))

Initializes a leaderboard request to retrieve the scores of a specific group of players.

### Deprecated properties

[`var category: String?`](/documentation/GameKit/GKLeaderboard/category)

The named leaderboard to retrieve information from.

[`var identifier: String?`](/documentation/GameKit/GKLeaderboard/identifier)

The named leaderboard to retrieve information from.

[`var isLoading: Bool`](/documentation/GameKit/GKLeaderboard/isLoading)

A Boolean value that indicates whether the leaderboard object is retrieving scores.

[`var localPlayerScore: GKScore?`](/documentation/GameKit/GKLeaderboard/localPlayerScore)

The score that the local player earns.

[`var maxRange: Int`](/documentation/GameKit/GKLeaderboard/maxRange)

The size of the leaderboard.

[`var playerScope: GKLeaderboard.PlayerScope`](/documentation/GameKit/GKLeaderboard/playerScope-swift.property)

A filter that restricts the search to a subset of the players in Game Center.

[`var range: NSRange`](/documentation/GameKit/GKLeaderboard/range)

The numerical score rankings to return from the search.

[`var scores: [GKScore]?`](/documentation/GameKit/GKLeaderboard/scores)

An array of scores that contains the scores that the search returns.

[`var timeScope: GKLeaderboard.TimeScope`](/documentation/GameKit/GKLeaderboard/timeScope-swift.property)

A filter that restricts the search to scores within a specific period of time.

### Deprecated methods

[`class func setDefault(String?, withCompletionHandler: (((any Error)?) -> Void)?)`](/documentation/GameKit/GKLeaderboard/setDefault(_:withCompletionHandler:))

Sets the default leaderboard for the local player.

[`class func loadCategories(completionHandler: (([String]?, [String]?, (any Error)?) -> Void)?)`](/documentation/GameKit/GKLeaderboard/loadCategories(completionHandler:))

Loads the list of leaderboard categories along with their corresponding localized titles.

[`class func loadLeaderboards(completionHandler: (([GKLeaderboard]?, (any Error)?) -> Void)?)`](/documentation/GameKit/GKLeaderboard/loadLeaderboards(completionHandler:))

Loads a list of leaderboards from Game Center.

[`func loadScores(completionHandler: (([GKScore]?, (any Error)?) -> Void)?)`](/documentation/GameKit/GKLeaderboard/loadScores(completionHandler:))

Retrieves a set of scores from Game Center.


---

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)