Documentation Archive


App Programming Guide for tvOS

iCloud Storage

Storage on Apple TV is limited, and there is no guarantee that information stored on the device will be available the next time a user opens your app. Also, in order to share the user’s data across multiple devices, you need to store the user’s information somewhere other than the Apple TV. Apple provides two shared storage options for Apple TV: iCloud Key-Value Storage (KVS) and CloudKit.

For small storage needs, under 1 MB, your app can use iCloud KVS. iCloud KVS automatically synchronizes information across all of a user’s devices. Only the owner of the app is able to access the information stored by iCloud KVS. Other users of your app are not able to access this information. For more information, see Designing for Key-Value Data in iCloud.

For large storage needs, greater than 1MB, your app needs to implement CloudKit. CloudKit allows information stored by one user to be accessed by another user. This is extremely useful in instances where the actions of one user affect the options of another user; for example, the actions taken by a user during a game turn that directly affect another user. For information on implementing CloudKit in your app, see CloudKit Quick Start.