# Permissions

# Required permissions

The following permissions need to be added to your Info.plist:

Permission Reason
NSLocationWhenInUseUsageDescription Describes how your app will use location services in the foreground. You must include this key if you wish to collect location events
NSLocationAlwaysAndWhenInUseUsageDescription Describes how your app will use location services and explains what extra features you can provide if the always option is selected. The presented alert gives the user the option between "Only when in use", "Always", and "Never". Only used on iOS 11 or later
NSLocationAlwaysUsageDescription Describes how your app will use location services, both in the foreground and background. The presented alert gives the user the option between "Always", and "Never". If your deployment target is at iOS 11 or higher, then you don't need this key even if you wish to collect location events
NSBluetoothAlwaysUsageDescription Describes how your app will use bluetooth, both in the foreground and background.
NSBluetoothPeripheralUsageDescription Describes how your app will use bluetooth, both in the foreground and background for OS versions prior to iOS 13

Note

If your application is targeting iOS 11 or higher, then only WhenInUseUsage and AlwaysAndWhenInUseUsage plist keys are required. If your application is targeting iOS 10 or below, then you need to include all four of these keys.