Locations

Configuring the locations and location-based groups on your domain

Overview

Network admins can configure office locations and manage location-based groups for all users in the domain.

---

List of Office Locations

The Locations tab displays all office locations added to your domain. Admins can:

• View the location photo and location name.

• Click the Manage Settings (cog wheel) to show/hide fields in the list.

• Use the Quick Find search bar to locate office locations quickly.

The location photo and the name of the location must be displayed.

---

Managing Office Locations

Each office location has a 3-dot action menu with additional options.

• Edit: Modify office location details such as address, contact information, or group associations.

• Delete: Remove an office location from the domain. When deleting, choose to leave the associated group as is or archive the group.

• Associate Location Group: Convert a general group into a location-based group. Only members with the matching office location remain in the group. Members outside this location are removed from the group.

• Disassociate Location Group: Converts the location-based group back into a general group. Admins must manually manage members. The disassociated group follows private group permissions.

• Re-sync Location Detail: Refresh office location details using API or Webhook.

Only network admins can edit or delete locations.

---

Managing Location-Based Groups

Location-based groups automatically update membership when users change their office location in their profiles. To make a Location Based Group, there must be a Location added without a group already associated with it.

To create a location-based group, click the Create Groups button to open the Create Location-Based Groups pop-up menu.

Locations without a group already associated will display text fields and a creation toggle switch.

For the selected location, enter a Group Name, Description, and assign a Group Admin. These can later be edited for the group from the Groups module.

Toggle the Create option to enable location-based grouping. Click the Create Groups button and the location-based group will be created.

Location-based groups can only be created for office locations that do NOT already have an associated group.

---

Bulk Importing Office Locations

To bulk import office locations using a .xlsx or .csv file click Import New Location option from the Add Locations dropdown.

Select Import from XLSX or Import from CSV to begin. Each location must have a unique name to be imported into MangoApps.

Ensure all mandatory fields—Address, City, State, and Zip Code—are included for a successful import.

The pop-up menu offers a downloadable sample template and sample values for reference. To avoid errors, make sure all column headings match exactly as shown in the sample.

Next, Click Choose File to upload the desired file.

Finally, select an import option: Skip existing location to ignore duplicates or Update existing location to update records for existing locations.

---

Importing Office Locations via API

To import an office location via API, click the Import via API option from the Add Locations dropdown.

Within the Import via API pop-up window, you will configure the URL to which the sync request will be sent. Fill in all applicable and mandatory fields in the window:

• Specify the API URL.

• Enter the external system ID for request and response parameters.

• Map the API fields to corresponding MangoApps fields.

• Click + Add to add more parameters or Remove to delete parameters.

• Click Save.

The external system ID must match your third-party API field for successful data exchanges. Refer to your API documentation for field mapping details.

Importing via API depends on location webhooks. See Webhooks for more information.