<!--
{
  "availability" : [
    "iOS: 26.0 -",
    "iPadOS: 26.0 -",
    "macCatalyst: 26.0 -",
    "macOS: 26.0 -",
    "visionOS: 26.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "GameSave",
  "identifier" : "/documentation/GameSave",
  "metadataVersion" : "0.1.0",
  "role" : "Framework",
  "symbol" : {
    "kind" : "Framework",
    "modules" : [
      "GameSave"
    ],
    "preciseIdentifier" : "GameSave"
  },
  "title" : "GameSave"
}
-->

# GameSave

Store and sync your application’s save files in iCloud.

## Overview

GameSave uses iCloud Drive to synchronize your application’s save data across devices. The framework provides a set of APIs for reading and writing one or more files to a directory, while abstracting away iCloud concepts. It handles common save syncing scenarios like conflict resolution and offline play. Additionally, it provides a set of convenience UI alerts for these typical scenarios. GameSave also supports local saving for when the device isn’t signed into iCloud Drive.

> Important:
> For GameSave to store the game data in the player’s iCloud account,
> you need to provide an identifier for the iCloud container that stores the data.
> Add the iCloud capability to your project and select the iCloud Documents checkbox.
> For more information,
> see <doc://com.apple.documentation/documentation/Xcode/configuring-icloud-services>.

## Topics

### Synced directory

[`GameSaveSyncedDirectory`](/documentation/GameSave/GameSaveSyncedDirectory)

A cloud-synced directory for game-save data.

### Error domain

[`GameSaveErrorDomain`](/documentation/GameSave/GameSaveErrorDomain)

The error domain name for GameSave errors.

### Synced directory (Objective-C)

[`GSSyncedDirectory`](/documentation/GameSave/GSSyncedDirectory)

A cloud-synced directory for game-save data.


---

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)