> For the complete documentation index, see [llms.txt](https://guides.mangoapps.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guides.mangoapps.com/admin-guide/module-settings/media-gallery/configure-custom-fields.md).

# Custom Fields

### Overview

Custom fields allow you to add specific information to media files and streamline organization in the Media Library. The **Files** and **Media Library** modules in MangoApps share these custom fields, enabling consistent metadata across files.

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

Custom fields can be required, reordered, and even mapped to external APIs for enhanced functionality.

***

### Adding a New Custom Field

Navigate to the **Custom Fields** tab and click to open the **Setup Custom Fields** pop-up.

In the pop-up, click **New Custom Field**. Enter the name of the field (e.g., "Mockup") in the **Field Name** text box.

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

Choose the appropriate field type from the dropdown list. To make this field mandatory when users upload media, check the **Required** box.&#x20;

***

**Enter Field Choices (For Multiple Choice Fields)**

If your field type is Multiple Choices, enter options in the text box.

***

### Editing and Deleting Custom Fields

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

**Editing**: To modify an existing custom field, open the **Setup Custom Fields** pop-up, click the **three dots** icon next to the field, and select **Edit**.

**Deleting**: To delete a custom field, open the **Setup Custom Fields** pop-up, click the **three dots** icon next to the field, and select **Delete**.&#x20;

{% hint style="info" %}
Deleting a field **only** removes its association with media files and **does not** delete the media itself.
{% endhint %}

***

### Reordering Custom Fields

Custom fields can be reordered by dragging and dropping them within the list.

Only fields of type **Multiple Choices** will appear in the search filters on the User Portal’s Media Library. Adjust the order based on relevance to improve searchability.

***

### Additional Tips for Custom Fields

* **API Mapping**: Custom fields can be mapped to external APIs to sync data between systems, helping maintain consistency and streamline updates.
* **Mandatory Custom Fields**: Custom fields marked as **Required** must be filled in by users during media uploads, ensuring critical metadata is always included.