# Managing Profile Fields

### Overview

Adding custom fields to your domain's user profiles provides a means to gather tailored information that aligns with specific business needs and processes. These fields allow organizations to capture unique data points relevant to their operations, such as employee IDs, departmental affiliations, project roles, or specialized skills. By incorporating custom fields into user profiles, companies can enhance data accuracy, enabling more detailed reporting and analysis. This customization supports internal workflows and ensures that essential information is readily available for decision-making and operational optimization. Overall, custom fields empower companies to adapt their user profiles to reflect the unique requirements and nuances of their business environment.

***

### Configuring Profile Fields

To configure a profile field/custom field, click the <img src="/files/-Lh9AhGA8KzvPW0lNuXs" alt="" data-size="original">(**Edit**) button for the preferred field to open the Field Properties pop-up:

<img src="/files/jZpeXjxJHVnKHk1gRUrk" alt="" width="543">

In the Field Properties pop-up, click the **toggle bar** for **Required Field** to set the field as a **mandatory** profile field on the User Portal.

Choose the preferred **Edit** mode for the profile filed.

* **Editable:** Select the **Editable** option to allow users to edit the content in the profile field.
* **Read Only:** Select the **Read Only** option to restrict users from editing the content in the profile field. If selected, only network admins can edit the content in the profile field.

Enter the character limit in the **Character Limit** text box for the profile field.

Enter any optional help/info text for the profile field in the **Info Text** text box.

Click the **toggle bar** for the **User Controlled Visibility** for the profile field. If enabled, this allows users to mark the profile field **Public** or **Private** to their preference and choose to display/hide its value from other users on the domain.

Choose the preferred **Default Visibility** of the profile field on the User Portal.

* **Public:** Select the **Public** option to, by default, display the content of the field to all users on the domain.&#x20;
* **Private:** Select the **Private** option to, by default, hide the content of the field from all users on the domain.

Click the **Save** button to save the configurations to the profile field. Then, click the **Save Settings** button to save the profile configurations to the People module.

***

### Adding a New Custom Field

Custom fields let you add additional data to people in MangoApps. You can create a field for stage, priority, cost, or anything else that’s important to your workflow, team, and company.&#x20;

To add a new custom field, click the **Setup Custom Fields** button to open the Setup Custom Fields pop-up:

<img src="/files/y1YxfoBAzh16d5TtEXxT" 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 user's profile if this custom field is enabled.

Select the **Type of the Field** from the drop-down list.&#x20;

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 the People directory using the custom fields.&#x20;

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

{% hint style="info" %}
Custom fields can be mapped to external APIs for syncing data.
{% endhint %}

{% hint style="info" %}
Custom profile fields can be used to create Condition-Based Shortcuts in the LHS Navigation. See [Navigation](/admin-guide/navigation.md#adding-a-condition-based-shortcut) for more information in the Admin Guide.
{% endhint %}

***

### Managing Custom Fields

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

#### Editing a Custom Field

In the Setup Custom Fields pop-up, click the<img src="/files/-LfxCNNu22YFlviqCJgo" alt="" data-size="original">(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, click the<img src="/files/-LfxCNNu22YFlviqCJgo" alt="" data-size="original">(three dots) button for a field and then click **Delete** to delete the custom field.

{% hint style="danger" %}
Deleting a custom field removes the custom field from the user's profile along with the value specified in it on the User Portal. For example, if 50 users have values assigned to the Social Security Number (a custom profile field) and the network admin deletes the Social Security Number custom field from the Admin Portal, the custom field and the value specified for it gets deleted from all the 50 users' profiles.
{% endhint %}

{% hint style="danger" %}
Deleted custom fields and their values **CANNOT** be recovered once deleted.
{% 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/module-settings/people/full-profile/managing-profile-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.
