Official Content

Specifies the reason for your app to access the user's location information while your app is in use.


Objects: Menu, Panel, Work With (Only Main Objects)
Generators: Apple


This property is offered under the Purpose Strings properties group available for Main Smart Device objects under the Apple group.

When an API that involves user privacy is used in an iOS device, as of iOS 8.0 you must ask the user for permission. For this reason, they must define the message that will be displayed to users in a dialog box that will prompt them for permission, describing the reason(s) why the application is going to use the content.

In particular, when using the Geolocation external object, this is the property where you have to enter the reason(s) why the application will access the user's location while running in the foreground. More specifically, this is required also if an Maps Control Type is used with Show My Location or the map is centered on the user's location, or if the StartTracking method is used.


  • A warning message like this will be displayed if you use location services but this property is not set.
    warning: In iOS 8.0 or later, a value for one of these properties is required when you use location services. ('Location When In Use Usage Description' of <Menu|Panel> for Smart Devices instance '%')
    The iOS version may vary depending on which XCode version is used with support as of iOS 8.0.

Runtime/Design time

This property applies only at design-time.

How to apply changes

To apply the corresponding changes when the property value is configured, Build the Main Object.

See Also

Last update: February 2024 | © GeneXus. All rights reserved. GeneXus Powered by Globant