<!--
{
  "availability" : [
    "iOS: -",
    "iPadOS: -",
    "macCatalyst: -",
    "macOS: -",
    "tvOS: -",
    "visionOS: -"
  ],
  "documentType" : "symbol",
  "framework" : "GameKit",
  "identifier" : "/documentation/GameKit/GKAchievementDescription/loadImage(completionHandler:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "GameKit"
    ],
    "preciseIdentifier" : "c:objc(cs)GKAchievementDescription(im)loadImageWithCompletionHandler:"
  },
  "title" : "loadImage(completionHandler:)"
}
-->

# loadImage(completionHandler:)

Loads the image to display when the player completes the achievement.

```
func loadImage(completionHandler: (@Sendable (UIImage?, (any Error)?) -> Void)? = nil)
```

## Parameters

`completionHandler`

A block that GameKit calls when this method completes the download.

    The block receives the following parameters:

- `image`: The image that represents the completed achievement. This parameter is `nil` if an error occurs.
- `error`: Describes an error if it occurs, or `nil` if the operation completes.

## Discussion

First, use the [`loadAchievementDescriptions(completionHandler:)`](/documentation/GameKit/GKAchievementDescription/loadAchievementDescriptions(completionHandler:)) method to download the achievement description objects, and then use this method to download the individual achievement images. While GameKit downloads an achievement image, you can display the placeholder image. If successful, GameKit sets the image property to the image it passes to the completion handler.

---

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)