# Assets

This tab allows users to manage metadata through **System fields** and **Custom fields**. 

System fields appear in the **System metadata** category, marked by a padlock icon ![:padlock:](https://docs.scaleflex.com/~gitbook/image?url=https%3A%2F%2Fscaleflexhq.atlassian.net%2Fgateway%2Fapi%2Femoji%2F588d875d-5e29-44c7-a236-f5dc2a69a257%2Fc8db3362-e15b-4380-ab5f-8c4e51f6d141%2Fpath\&width=300\&dpr=4\&quality=100\&sign=86fbbfea\&sv=1)  and cannot be deleted. **Custom metadata**, however, is fully customizable and can be added, reordered, edited, or removed by users.

## User Actions

Users can perform the following actions:

* **Search fields** by Name or API Key.
* **Organize groups**: Reorder custom metadata groups.
* **Manage fields**: Add, edit, or delete custom fields and groups.

## Searching for fields

You can search for fields by either **Name** or **API Key**. This filter applies to both System and Custom fields.

## Managing system fields

Each asset includes two essential metadata fields:

* **Title**
* **Description**

Both fields are of the "Short text" type and support regional language variants.

## Managing custom fields

### **Adding a new group**

To create a new group:

1. Click the **+ Add new group** button.
2. The group will be added to the bottom of the custom groups list, and the screen will auto-scroll to the new group.
3. Use the `...` button to rename or delete the group as needed.
4. To add fields to the group, click **+ Add new field**.

### **Managing an existing group**

After adding fields, use the `...` button to edit or delete each field.

### **Reordering groups**

To reorder groups, click the  ![:organize:](https://docs.scaleflex.com/~gitbook/image?url=https%3A%2F%2Fscaleflexhq.atlassian.net%2Fgateway%2Fapi%2Femoji%2F588d875d-5e29-44c7-a236-f5dc2a69a257%2F0ad340fd-b785-42e5-81f3-b1fc59b72a87%2Fpath\&width=300\&dpr=4\&quality=100\&sign=7f4c86ac\&sv=1) **Organize** button, then drag and drop groups using the reorder icon ![:reorder:](https://docs.scaleflex.com/~gitbook/image?url=https%3A%2F%2Fscaleflexhq.atlassian.net%2Fgateway%2Fapi%2Femoji%2F588d875d-5e29-44c7-a236-f5dc2a69a257%2F932a651d-bd57-4995-a506-b92422b4c702%2Fpath\&width=300\&dpr=4\&quality=100\&sign=df5af944\&sv=1)

### **Adding a custom field to a group:**

When adding a new field:

1. Click **+ Add new field**.
2. A modal appears with options to configure the new field, including:
   * **Visibility**: Toggle ON/OFF whether to show the field in the public API response header.
   * **Name**: The display name of the metadata field.
   * **API Key**: Used to store/retrieve metadata information from the backend. It auto-fills based on the Name but can be manually edited (avoid special characters).
   * **Type**: Defines the data type (e.g., Text, Number). Select this only when creating the field, as it cannot be changed later. For details on supported types, see the [**Metadata Field Types**](#metadata-field-types) section.
   * **Placeholder**: Example text that guides users on what to enter in the field.
   * **Info Tooltip**: Optional, providing extra details on expected field values.
   * **Metadata Variant**: Select from available[ metadata variants](/digital-asset-management-dam/settings/metadata/metadata-configuration.md#variants). Note that if the field Type is "List" (single or multiple values), Metadata Variant will be disabled.
   * **Required**: Toggle ON/OFF if this field must be filled in for each asset. Required fields must be populated during asset upload, or DAM will explicitly prompt for completion.
3. After setting up the field, click **Add** to finalize it. Repeat this process for additional fields as needed, and ensure you click **Save** to apply all changes. Unsaved changes will be lost.

<figure><img src="/files/nOdP1Cquc1vJEkpD2m6r" alt=""><figcaption></figcaption></figure>

### **List of options**

When the user chooses *List (single value)* or *List (multiple values)* type for the metadata field, they have to provide one or more list options with the following details per each:

* **API key**
* **Option’s** **value**<br>

  <figure><img src="/files/iWqEnr2ZlJnDJJQ3h0Rc" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
The API key is automatically created on the basis of the Value.
{% endhint %}

### **Editing a Custom field**

Editing a custom field follows the same steps as adding, with the following exceptions:

* **Type** and **Metadata Variant** cannot be modified after the field is created.

### Metadata field types

<table><thead><tr><th width="158">Name</th><th width="159">Type</th><th width="303">Description</th><th>Examples (used for)</th></tr></thead><tbody><tr><td>Short text</td><td>TEXT</td><td>Free text is shown on 1 line. Does not accept line breaks.</td><td>Title</td></tr><tr><td>Long text</td><td>TEXTAREA</td><td>Similar to "Short text" but you can place inside longer content and paragraphs.</td><td>Description</td></tr><tr><td>Boolean</td><td>BOOLEAN</td><td>True/False indicator. <em>Note: In the DAM UI it is visualised as a check-box.</em></td><td><p>"Approved"</p><p><em>or</em></p><p>"Published"</p></td></tr><tr><td>Date</td><td>DATE</td><td>Calendar date format.</td><td>Created at</td></tr><tr><td>Number (integer)</td><td>INTEGER</td><td><p>Positive and round number.</p><p><em>Note: takes only digits.</em></p></td><td>Order number</td></tr><tr><td>List (single value)</td><td>SELECT</td><td><p>List with pre-defined options, where only one can be selected.</p><p><em>Note: should not be used for more than 100 options to chose from.</em></p></td><td>Country of origin</td></tr><tr><td>List (multiple values)</td><td>MULTI-SELECT</td><td>List with predefined options, where multiple values can be selected. <em>Note: should not be used for more than 100 options to chose from.</em></td><td>Markets</td></tr><tr><td>Supertags</td><td>TAGS</td><td>Custom-defined list of tags, optimised for faster search in the system</td><td>Customers</td></tr><tr><td>URI-type attachment</td><td>URI</td><td>Link to an <em>external</em> (WWW) asset or resource.<br>Officially supported URI schemes are: <br> - url (http://xx, https://xx, www.xx) <br> - phone (tel:+xx) <br> -email (mailto:xx) Other URI schemes will also function but are not documented</td><td>Privacy policy</td></tr><tr><td>Asset-type attachment</td><td>ATTACHMENT</td><td>Attach an internal hub asset Can add up to 5 attachments per metadata -- all hub assets types (video, image, pdf..) are supported</td><td>Asset</td></tr><tr><td>Geo-Point (coordinates)</td><td>DECIMAL x2</td><td><p>GPS coordinates in a (latitude,longitude) format.</p><p>Latitude must be between -90 and 90, longitude must be between -180 and 180.<br></p></td><td></td></tr></tbody></table>


---

# 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://docs.scaleflex.com/digital-asset-management-dam/settings/metadata/assets.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.