🆕General Settings

Configuring domain-wide location settings

Overview

The Locations settings in the MangoApps Admin Portal allow domain admins to configure how office locations are managed and displayed across the network. From this page, admins can enable office location visibility on user profiles, customize location and headquarters labels, and set the preferred order for displaying locations.

Additionally, admins can enforce Off-Location Access Restrictions. This feature limits navigation access when users are outside of their designated office locations. Admins can define user segments, specify alternate navigation options for off-location users, set allowable access distances for web and mobile, and require user consent when applying these restrictions.


Enabling Office Locations

To allow the addition of office locations within the domain, toggle the Enable Office Locations switch on or off. When at least one office location is added, MangoApps automatically generates a Company Office Locations page.


Configuring Office Location Labels

Location Label: Enter the preferred label for the office locations as they will appear on user profiles.

By default, MangoApps does not show a user’s office location on their profile.

To show location, navigate to Admin Portal > Modules > People > Full Profile.

Headquarter Label: Define the label for office locations designated as headquarters. This label appears on the Company Office Locations page and in the Office Locations list in the Admin Portal.


Sorting Office Locations

Choose how office locations are displayed on the location page under the Company module:

  • Alphabetically (A-Z)

  • Based on a user's location


Off-Location Access Restriction

The Off-Location Access options ensure a secure and location-aware user experience, while allowing for flexible management of access rules based on physical proximity.

To enable Off-Shift Restrictions navigate to Admin Portal > Domain > Locations > Settings. By default, this option will be disabled. In order to fully utilize this feature, office locations must have Latitude/Longitude values or address details entered in order to auto-calculate the location. This information can be entered under Domain > Locations > Locations.


Configurable Options

When user belongs to user segment __ and the user is away from their office location: Select which groups should experience location-based restrictions. A maximum of 3 user segments can be selected.

Then show navigation: Choose the navigation option to display for users accessing the application from locations far from their office.

Web Access Distance: The radius around the designated office location within which users can access the platform from the web browser and be considered as being at their office location.

Mobile Access Distance: The radius around the designated office location within which users can access the platform from the mobile app and be considered as being at their office location.

Consent Required: Enable this feature to require users accessing the system from outside their designated office location to accept a consent message. The message will appear once every hour as long as the user is outside the office location and will be captured in the log.

Consent Message: Provide a custom message to display to users accessing the system outside their designated office location. Ensure the message clearly outlines the terms they must accept.


User Experience

If enabled, MangoApps will prompts users upon log-in to allow access to their device’s location. The user’s current coordinates are then compared with their assigned office location.

  • Within allowed distance: Full navigation access is provided.

  • Outside allowed distance:

    • The user sees a customizable Consent Prompt.

    • After consenting, they gain limited navigation access.

Consent Expiry: Consent must be re-confirmed if the user remains logged in and off-location for more than 1 hour.

Consent logs can be found in Admin Portal > Home > Logs > Restricted Access Consent Logs.


FAQ

Q: What determines whether a user is considered "off location"? Does it use IP address or location data? What happens if location data is turned off?

A: The Off Location Access feature uses the device's location data (from a phone or computer) to determine if the user is within the geofence set by the company’s admin. It does not rely on IP address. If location data is turned off on the device, the system treats the user as being off location, and their access will be restricted accordingly.

Last updated