iOS Customizations

By default, the Actito SDK automatically manages most of the complexity around location services — including region monitoring, beacon tracking, and visit detection.

However, you may want finer control over how these mechanisms behave or how they integrate with your app’s own location logic. This page explains the available configuration options related to location services, and how to adjust them to suit your app’s needs.

💡 All the configurations described on this page can be defined in your app’s ActitoOptions.plist file. See the Customizations guide for details on how this file works.

Increase the limit for monitored regions

When location services are enabled and the user has granted the necessary permissions, the Actito SDK automatically monitors regions and beacons.

By default, the SDK monitors up to 10 regions and 10 beacons simultaneously when inside a region. If your app relies more heavily on region monitoring and doesn’t need to account for beacons, you can increase the number of monitored regions by setting a custom limit in your ActitoOptions.plist.

<plist version="1.0">
<dict>
    <key>MONITORED_REGIONS_LIMIT</key>
    <integer>20</integer>
</dict>
</plist>

When you set this custom limit to match the system’s maximum region limit, beacon monitoring will be disabled. If you choose a lower value, the SDK will use the remaining capacity for beacons — for example, if the system limit is 20, and you set 15, the SDK will monitor up to 5 beacons.