# Location Fields

### Overview

Admins can edit existing fields or create new custom fields for office locations.&#x20;

<img src="/files/CMuerYLQYg1Kxm9UoYXa" alt="" width="563">

These fields are displayed when a new location is being added using the [Add Locations](https://guides.mangoapps.com/admin-guide/domain-settings/locations/locations/adding-an-office-location) button and on the locations details menu in the Company module.&#x20;

<figure><img src="/files/H1LrHEzZAJzKn9fGm1FW" alt="" width="563"><figcaption></figcaption></figure>

Admins can also map these fields to external servers and data sources using webhooks. See [Webhooks](https://guides.mangoapps.com/admin-guide/domain-settings/locations/webhooks) for more information.

***

### **Locations Fields List**

**Mandatory fields:** The list includes 3 system default fields (Office Image, Name, Address) and 1 system default section (Summary). These fields **cannot** be unchecked.

**Optional fields:** MangoApps includes a handful of optional fields that can help provide additional information for an office location. These fields can be re-ordered by dragging and dropping the fields in the list. These fields can also be omitted from location details and location set up menus by unchecking the associated check box.

<figure><img src="/files/cIQRl9Ub7eD0Yyt5OSYv" alt="" width="563"><figcaption></figcaption></figure>

***

### Setting Up Additional Fields

Click the **Setup Additional Fields** button to add a new custom field for the office locations.

<figure><img src="/files/O2aDEZIrydp61nrTbMHE" alt="" width="563"><figcaption></figcaption></figure>

Click the **Add a Section** button to add a new section to the location fields on the location details menu. This new section will be added below the **Additional Information** section.&#x20;

<figure><img src="/files/lW9CX1pD80ZnitM9oiJa" alt="" width="507"><figcaption></figcaption></figure>

These sections can be re-ordered in the list as well via drag-and-drop.

{% hint style="warning" %}
The **Summary** section will **always** be listed first.
{% endhint %}

Click the **Add & Edit Location Fields** button to access the **Setup Custom Fields** menu for locations.

<img src="/files/jUvYT7rMkjiF9zkQlhcS" alt="" width="563">

In the **Setup Custom Fields** pop-up, click the **New Custom Field** button.

Enter the **Title** for the new custom field in the Field Name text box. This is the title which will appear on a location's details sheet if the custom field is enabled.

Select the **Type of the Field** from the drop-down list.

Optionally, mark the **Available as Search Filter** check box to add the custom field to the search filters list on the User Portal to allow users to search for locations and location groups using the custom fields.

Once satisfied, click the **Save** button.

***

### Managing Custom Fields <a href="#managing-custom-fields" id="managing-custom-fields"></a>

<figure><img src="/files/SyPgr26WI5XteGl02Rvz" alt="" width="563"><figcaption></figcaption></figure>

**Editing a Custom Field**

In the **Setup Custom Fields** pop-up, click the![](https://guides.mangoapps.com/~gitbook/image?url=https%3A%2F%2F1733114811-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-legacy-files%2Fo%2Fassets%252F-Lclpq021Ai9jH1_X4gO%252F-Lfx0PY7jHAbQWLhNl8k%252F-LfxCNNu22YFlviqCJgo%252FHolidays%2520-%2520edit%2520-%2520clone%2520-%2520delete%2520button.png%3Falt%3Dmedia%26token%3Dc87dbc08-1a5f-4e40-807e-beceeebcc032\&width=300\&dpr=4\&quality=100\&sign=67980d\&sv=2)(three dots) button for a field and then click **Edit** to edit the custom field.

**Deleting a Custom Field**

In the **Setup Custom Fields** pop-up menu, click the![](https://guides.mangoapps.com/~gitbook/image?url=https%3A%2F%2F1733114811-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-legacy-files%2Fo%2Fassets%252F-Lclpq021Ai9jH1_X4gO%252F-Lfx0PY7jHAbQWLhNl8k%252F-LfxCNNu22YFlviqCJgo%252FHolidays%2520-%2520edit%2520-%2520clone%2520-%2520delete%2520button.png%3Falt%3Dmedia%26token%3Dc87dbc08-1a5f-4e40-807e-beceeebcc032\&width=300\&dpr=4\&quality=100\&sign=67980d\&sv=2)(three dots) button for a field and then click **Delete** to delete the custom field.


---

# 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/location-fields.md?ask=<question>
```

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.
