<!--
{
  "availability" : [
    "iOS: 26.0.0 -",
    "iPadOS: 26.0.0 -",
    "macCatalyst: 26.0.0 -",
    "macOS: 26.0.0 -",
    "tvOS: 26.0.0 -",
    "visionOS: 26.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "GameKit",
  "identifier" : "/documentation/GameKit/GKGameActivityDefinition",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "GameKit"
    ],
    "preciseIdentifier" : "c:objc(cs)GKGameActivityDefinition"
  },
  "title" : "GKGameActivityDefinition"
}
-->

# GKGameActivityDefinition

An object that represents the static metadata you define for the activity.

```
class GKGameActivityDefinition
```

## Topics

### Getting the display properties and image

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

A short title for the game activity.

[`details`](/documentation/GameKit/GKGameActivityDefinition/details)

A more detailed description of the game activity.

[`defaultProperties`](/documentation/GameKit/GKGameActivityDefinition/defaultProperties)

Default properties defined by the developer for this type of game activity.

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

Asynchronously load the image. Error will be nil on success.

### Getting the activity capabilities

[`supportsPartyCode`](/documentation/GameKit/GKGameActivityDefinition/supportsPartyCode)

Whether the activity can be joined by others via a party code.

[`supportsUnlimitedPlayers`](/documentation/GameKit/GKGameActivityDefinition/supportsUnlimitedPlayers)

True if the activity supports an unlimited number of players. False if maxPlayers is set to a defined limit or if no player range is provided.

[`playerRange`](/documentation/GameKit/GKGameActivityDefinition/playerRange)

The range of players supported by this type of game activity.

[`playStyle`](/documentation/GameKit/GKGameActivityDefinition/playStyle)

The play style of the game activity.

[`GKGameActivityPlayStyle`](/documentation/GameKit/GKGameActivityPlayStyle)

Play Style of the game activity. It can be either Asynchronous or Synchronous.

### Getting the fallback URL

[`fallbackURL`](/documentation/GameKit/GKGameActivityDefinition/fallbackURL)

A fallback URL that can be used to construct a game-specific URL for players to share or join, if the joining device does not support the default URL.

### Getting the release state

[`releaseState`](/documentation/GameKit/GKGameActivityDefinition/releaseState)

The release state of the game activity definition in App Store Connect.

[`GKReleaseState`](/documentation/GameKit/GKReleaseState)

Describes the release state of an App Store Connect resource, such as an Achievement or Leaderboard.

### Getting the identifier properties

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

The developer defined identifier for a given game activity.

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

The group identifier for the activity, if one exists.

### Loading activity definitions

[`+  loadGameActivityDefinitionsWithCompletionHandler:`](/documentation/GameKit/GKGameActivityDefinition/loadGameActivityDefinitions(completionHandler:))

Loads all the game activity definitions for the current game.

[`+  loadGameActivityDefinitionsWithIDs:completionHandler:`](/documentation/GameKit/GKGameActivityDefinition/loadGameActivityDefinitions(IDs:completionHandler:))

Loads game activity definitions with the supplied App Store Connect identifiers.

### Loading achievement descriptions

[`-  loadAchievementDescriptionsWithCompletionHandler:`](/documentation/GameKit/GKGameActivityDefinition/loadAchievementDescriptions(completionHandler:))

Loads all associated achievements that have defined deep links to this game activity definition.

### Loading leaderboards

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

Loads all associated leaderboards that have defined deep links to this game activity definition.

## Relationships

### Conforms To

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

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

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

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

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

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

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

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

### 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)