---
description: Configuring the locations and location-based groups on your domain
---

# Locations

### Overview

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

![](https://1733114811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lclpq021Ai9jH1_X4gO%2Fuploads%2Fyaf5Ac5Z8Zh288ma4CS9%2F04-03-2025-03-17-49.png?alt=media\&token=cf1149f4-56c2-47f4-9e1e-978640c726fd)

***

### 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.

<figure><img src="https://1733114811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lclpq021Ai9jH1_X4gO%2Fuploads%2FdQWpHMYQPNr0kh4hQnhB%2F05-03-2025-01-46-27.png?alt=media&#x26;token=45069248-4578-4a64-aed6-41ba0e119c8b" alt="" width="563"><figcaption></figcaption></figure>

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.

<figure><img src="https://1733114811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lclpq021Ai9jH1_X4gO%2Fuploads%2FpqmGjzd3FuoshKd7bXdT%2F05-03-2025-02-09-07.png?alt=media&#x26;token=f19c5c4d-f984-4d82-bac3-51c282c3005e" alt="" width="563"><figcaption></figcaption></figure>

* **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**.

{% hint style="info" %}
Only network admins can edit or delete locations.
{% endhint %}

***

### 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**](https://guides.mangoapps.com/admin-guide/domain-settings/locations/locations/adding-an-office-location) 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.

<figure><img src="https://1733114811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lclpq021Ai9jH1_X4gO%2Fuploads%2FOpykd2gK4gADNQnPzkY4%2F05-03-2025-03-07-16a.png?alt=media&#x26;token=d41bf474-5143-4f3f-99f6-58c2b38ac532" alt="" width="563"><figcaption></figcaption></figure>

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**](https://guides.mangoapps.com/admin-guide/module-settings/groups).

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

{% hint style="info" %}
Location-based groups can only be created for office locations that do **NOT** already have an associated group.
{% endhint %}

***

### 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.

<figure><img src="https://1733114811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lclpq021Ai9jH1_X4gO%2Fuploads%2FfRA0UXCGxBVVebEFPLAm%2F05-03-2025-03-42-03.png?alt=media&#x26;token=df604cc8-d3aa-448e-8260-03e37bf3d5d7" alt="" width="563"><figcaption></figcaption></figure>

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.

<figure><img src="https://1733114811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lclpq021Ai9jH1_X4gO%2Fuploads%2FYbtIUOEkztmyeL83omz2%2F06-03-2025-09-10-50.png?alt=media&#x26;token=18a90bb6-cc70-4709-a877-4e7de6aad0bc" alt="" width="563"><figcaption></figcaption></figure>

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**.

{% hint style="danger" %}
The external system ID **must** match your third-party API field for successful data exchanges. Refer to your API documentation for field mapping details.&#x20;

Importing via API depends on location webhooks. See [**Webhooks**](https://guides.mangoapps.com/admin-guide/domain-settings/locations/webhooks) for more information.
{% endhint %}



