Last Updated: 2018-05-28

iOS App Permission Usage Description Keys

A quick reference list of all of the keys for permissions you may need to add to you app.


All-in-one

Key Usage
NSPhotoLibraryAddUsageDescription Your app adds photos to the user's photo library
NSPhotoLibraryUsageDescription Your app accesses the user's photo library
NSCameraUsageDescription Your app uses the device camera
NSLocationAlwaysUsageDescription Your app uses location services all the time
NSLocationWhenInUseUsageDescription Your app uses location services only when the app is running
NSLocationUsageDescription DEPRECATED: Update to one of the above instead
NSContactsUsageDescription Your app uses the address book
NSCalendarsUsageDescription Your app uses or modifies the user's calendar information
NSRemindersUsageDescription Your app creates reminders in the Reminders app
NSHealthShareUsageDescription Your app uses data from the Health app
NSHealthUpdateUsageDescription Your app provides health information to the Health app
NFCReaderUsageDescription Your app uses the NFC reader
NSBluetoothPeripheralUsageDescription Your app works with Bluetooth devices
NSMicrophoneUsageDescription Your app uses the device microphone
NSSiriUsageDescription Your app provides a SiriKit Intent
NSSpeechRecognitionUsageDescription Your app uses speech recognition
NSMotionUsageDescription Your app uses the device motion tracking hardware
NSVideoSubscriberAccountUsageDescription (tvOS only) your app uses the video subscriber account
NSAppleMusicUsageDescription Your app uses Apple Music integration
NSFaceIDUsageDescription Your app uses FaceID

Add them all quickly

<key>NFCReaderUsageDescription</key>
<string>Example: You should fill this in</string>

<key>NSBluetoothPeripheralUsageDescription</key>
<string>Example: You should fill this in</string>

<key>NSCalendarsUsageDescription</key>
<string>Example: You should fill this in</string>

<key>NSCameraUsageDescription</key>
<string>Example: You should fill this in</string>

<key>NSContactsUsageDescription</key>
<string>Example: You should fill this in</string>

<key>NSHealthShareUsageDescription</key>
<string>Example: You should fill this in</string>

<key>NSHealthUpdateUsageDescription</key>
<string>Example: You should fill this in</string>

<key>NSHomeKitUsageDescription</key>
<string>Example: You should fill this in</string>

<key>NSLocationAlwaysUsageDescription</key>
<string>Example: You should fill this in</string>

<key>NSLocationUsageDescription</key>
<string>Example: You should fill this in</string>

<key>NSLocationWhenInUseUsageDescription</key>
<string>Example: You should fill this in</string>

<key>NSMicrophoneUsageDescription</key>
<string>Example: You should fill this in</string>

<key>NSMotionUsageDescription</key>
<string>Example: You should fill this in</string>

<key>NSPhotoLibraryAddUsageDescription</key>
<string>Example: You should fill this in</string>

<key>NSPhotoLibraryUsageDescription</key>
<string>Example: You should fill this in</string>

<key>NSRemindersUsageDescription</key>
<string>Example: You should fill this in</string>

<key>NSSiriUsageDescription</key>
<string>Example: You should fill this in</string>

<key>NSSpeechRecognitionUsageDescription</key>
<string>Example: You should fill this in</string>

<key>NSVideoSubscriberAccountUsageDescription</key>
<string>Example: You should fill this in</string>

<key>NSAppleMusicUsageDescription</key>
<string>Example: You should fill this in</string>

<key>NSFaceIDUsageDescription</key>
<string>Example: You should fill this in</string>

There's more to read!

Did this help solve your problem? If so, consider letting us know on Twitter. You should follow us for all the latest articles and updates:


Have you seen our latest project on Github?.

Sign up for our newsletter

Get an email when new content comes out! Emails are not sold and are used only for announcing updates to the site. Expect ~1-2 emails per month. Unsubscribe any time.