# Locations
### 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**.
{% 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.
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.
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**.
{% 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.
Importing via API depends on location webhooks. See [**Webhooks**](https://guides.mangoapps.com/admin-guide/domain-settings/locations/webhooks) for more information.
{% endhint %}
