# 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 %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://guides.mangoapps.com/admin-guide/domain-settings/locations/locations.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.