---
title: NSLocationWhenInUseUsageDescription
framework: bundleresources
role: symbol
role_heading: Property List Key
path: bundleresources/information-property-list/nslocationwheninuseusagedescription
---

# NSLocationWhenInUseUsageDescription

A message that tells people why the app is requesting access to their location information while the app is running in the foreground.

## Discussion

Discussion Use this key if your iOS app accesses location information only when running in the foreground. If your app needs location information when in the background, use NSLocationAlwaysAndWhenInUseUsageDescription instead. For more information, see Choosing the  Location Services Authorization to Request. If you need location information in a macOS app, use NSLocationUsageDescription instead. important: This key is required if your iOS app uses APIs that access the user’s location information while the app is in use.

## See Also

### Location

- [Choosing the  Location Services Authorization to Request](bundleresources/choosing-the-location-services-authorization-to-request.md)
- [NSLocationAlwaysAndWhenInUseUsageDescription](bundleresources/information-property-list/nslocationalwaysandwheninuseusagedescription.md)
- [NSLocationUsageDescription](bundleresources/information-property-list/nslocationusagedescription.md)
- [NSLocationTemporaryUsageDescriptionDictionary](bundleresources/information-property-list/nslocationtemporaryusagedescriptiondictionary.md)
- [NSLocationAlwaysUsageDescription](bundleresources/information-property-list/nslocationalwaysusagedescription.md)
- [NSWidgetWantsLocation](bundleresources/information-property-list/nswidgetwantslocation.md)
- [NSLocationDefaultAccuracyReduced](bundleresources/information-property-list/nslocationdefaultaccuracyreduced.md)