Document Revision History

This table describes the changes to Information Property List Key Reference.

DateNotes
2016-11-14

Corrected the App Transport Security key name for media loads, to NSAllowsArbitraryLoadsForMedia.

2016-10-27

Updated guidance in App Store Review for ATS.

2016-09-13

Added keys for providing purpose strings for accessing user data or device resources: NSAppleMusicUsageDescription, NSHomeKitUsageDescription, NSSiriUsageDescription, NSSpeechRecognitionUsageDescription, and NSVideoSubscriberAccountUsageDescription.

 

Throughout the Cocoa Keys chapter, added warnings to all purpose string (…UsageDescription) keys explaining that, to support user privacy, you must statically declare your intent to use protected resources.

 

Added a description for the iOS keys CoreSpotlightContinuation, UIWhitePointAdaptivityStyle, and UIApplicationShortcutWidget.

 

Added descriptions for four NSAppTransportSecurity subkeys: NSAllowsArbitraryLoadsInMedia, NSAllowsArbitraryLoadsInWebContent, NSAllowsLocalNetworking, and NSRequiresCertificateTransparency. Also expanded and clarified the description of the NSAppTransportSecurity key.

 

Removed all mention of the following third-party-server exception keys from the description for the NSAppTransportSecurity key; Apple no longer expects apps to specify any of them: NSThirdPartyExceptionAllowsInsecureHTTPLoads, NSThirdPartyExceptionRequiresForwardSecrecy, NSThirdPartyExceptionMinimumTLSVersion.

 

Added a note in the See Also section, in About Info.plist Keys and Values, describing keys specific to kernel extension development.

 

Clarified the guidance for use of the CFBundleShortVersionString and NSHomeKitUsageDescription keys.

 

Corrected the information about language IDs for the CFBundleDevelopmentRegion key.

 

Added the Safari App Extension Keys section to the App Extension Keys chapter.

 

Added listing of two tvOS app extension keys, com.apple.broadcast-services and com.apple.tv-services, in Table 2.

 

Added description for the WKBackgroundModes key, as well as watchOS information for the audio subkey of the UIBackgroundModes key.

 

Added description for the UIUserInterfaceStyle key for tvOS.

 

Added description for the GCSupportsMultipleMicroGamepads key for tvOS and for the GCSupportedGameControllers key for tvOS, iOS, and macOS.

 

Renamed the “OS X Keys” chapter to macOS Keys.

2016-03-01

Added a description for the NSSupportsPurgeableLocalStorage key for declaring support for Shared iPad, a feature of iOS device management.

 

Added a description for the NETestAppMapping key for testing and development of per-app VPN app extensions.

2015-12-08

Improved and expanded the guidance for the NSAppTransportSecurity (App Transport Security) key.

2015-10-21

Added descriptions for the keys for configuring App Transport Security (ATS). See the NSAppTransportSecurity section.

 

Added information, in the CFBundleIcons section, about use of icon files in tvOS.

2015-09-16

Added descriptions for the UIApplicationShortcutItems key, and related keys, for specifying static Home screen quick actions on devices that support 3D Touch.

 

Added a description for the LSSupportsOpeningDocumentsInPlace Launch Services key.

2015-08-25

Added a new chapter: watchOS Keys.

 

Updated guidance in the Creating Platform- and Device-Specific Keys section.

 

Added information about the LSApplicationQueriesSchemes key, which lets you specify the URL schemes an app is able to test with the canOpenURL: method.

 

Updated the description of the CFBundleURLTypes key to mention its relationship with the LSApplicationQueriesSchemes key.

2015-03-09

Added the NSExtensionPointIdentifier string for a WatchKit App extension.

2014-09-17

Added new keys introduced in iOS 8.

2014-02-11

Added the opengles-3 key for required device capabilities.

2013-09-18

Added OS X v10.9 availability for NSLocationUsageDescription.

 

Added keys introduced in iOS 7.

2012-09-19

Added keys related to the configuration of an app to support 3rd party map directions and keys related to user privacy.

2012-02-16

Added info to CFBundleURLTypes regarding RSS feeds.

2011-10-12

Added a new value to the UIRequiredDeviceCapabilities key to reflect support for low-power Bluetooth hardware.

 

Incorporates keys introduced in iOS 5.0.

2011-06-06

Added information about key support in OS X v10.7.

2010-11-15

Corrected the availability of the LSMinimumSystemVersion and MinimumOSVersion keys.

2010-08-20

Fixed some typographical errors.

2010-07-08

Changed references of iOS to iOS.

2010-06-14

Added new keys introduced in iOS 4.0.

2010-03-23

Added keys specific to iOS 3.2.

 

Removed the LSHasLocalizedDisplayName key, which was deprecated in OS X v10.2.

2009-10-19

New document describing the keys you can use in a bundle's Info.plist file.