# 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.
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.
Choose the appropriate field type from the dropdown list. To make this field mandatory when users upload media, check the **Required** box.
***
**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
**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**.
{% 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.
---
# 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/media-gallery/configure-custom-fields.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.