# Location Fields

### Overview

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

![](https://1733114811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lclpq021Ai9jH1_X4gO%2Fuploads%2FFyUggEmaG9Iw81hWP1lK%2F10-03-2025-01-57-06.png?alt=media\&token=1f4e7f2d-76f2-4cfa-8fde-c33cf7a93a6d)

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="https://1733114811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lclpq021Ai9jH1_X4gO%2Fuploads%2FinKtvqHuTbrVTWAO30La%2F10-03-2025-03-39-53.png?alt=media&#x26;token=dbc16f5c-2b0d-4dd1-9ac8-4022317c7752" 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="https://1733114811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lclpq021Ai9jH1_X4gO%2Fuploads%2F26vxB7BB57vEvq9lhEhX%2F10-03-2025-01-57-06a.png?alt=media&#x26;token=a9d65823-e055-4765-8bc5-0485bab2fa89" 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="https://1733114811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lclpq021Ai9jH1_X4gO%2Fuploads%2Fr6TzzqTyaT2bGqknXTzv%2F10-03-2025-03-12-26.png?alt=media&#x26;token=7552b993-be39-487c-b918-d2b74b43d5fb" 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="https://1733114811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lclpq021Ai9jH1_X4gO%2Fuploads%2FRDfBm6h9lUFoEH0wdsve%2F10-03-2025-03-33-35.png?alt=media&#x26;token=3d0c9b1c-6fa7-4ae1-8a14-ba4d636de612" 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.

![](https://1733114811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lclpq021Ai9jH1_X4gO%2Fuploads%2FQc6DvrA6JIObsslVLiGh%2Fsdfger.png?alt=media\&token=605b0aa5-062b-44fc-a2b6-7332cec09dd3)

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="https://1733114811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lclpq021Ai9jH1_X4gO%2Fuploads%2FhIRc7VPXHNsJpXJXHXy7%2F10-03-2025-03-37-08.png?alt=media&#x26;token=496c4abd-8664-442c-8646-634554dd5bb7" 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.
