How to configure the Upload with Metadata option

In File Manager, files can optionally be uploaded with metadata.

By default, metadata upload is disabled.

Configuration is performed in the fileMetadataAttributes section of the Edit Configurations window.

1. Go to Services → Servers.

2. Click the HTTP or HTTPS server card where File Manager is configured.

3. Scroll down to the Applications section.

4. Click the edit icon to open the Edit Configurations window.

The first and mandatory step to show the arrow and its Upload with metadata menu entry is to set the enable parameter to true.

To display the arrow next to the Upload button - revealing the Upload with metadata option - you must enable the feature.

"config": {
    "fileMetadataAttributes": {
      "enable": true,

When enabled, the Upload button will show an additional arrow with the Upload with metadata entry.

If you still do not see the arrow or the menu, clear your browser cache.

After enabling the feature, configure the fields that appear in the Upload with metadata dialog. This is done in the fields array:

"config": {
    "fileMetadataAttributes": {
      "enable": false,
      "fields": [
        {
          "name": "classification",
          "mandatory": true,
          "values": [
            "public",
            "secret"
          ],
          "defaultValue":"public",
          "labels": {
            "it": "Livello di riservatezza",
            "en": "Classification level"
          }
        },
        {
          "name": "sendernote",
          "mandatory": false,
          "maxLength":80,
          "defaultValue":"",
          "labels": {
            "it": "Nota del mittente",
            "en": "Sender note"
The sample file contains a Classification Level mandatory field with 2 entries: public and secret. 

      "fields": [
        {
          "name": "classification",
          "mandatory": true,
          "values": [
            "public",
            "secret"
          ],
          "defaultValue":"public",
          "labels": {
            "it": "Livello di riservatezza",
            "en": "Classification level"
          }
        },

Where:

• name: the ID of the metadata field.

• mandatory:

  • true → the field cannot be empty.

  • An asterisk * appears in the dialog as a visual indicator.

• values: creates a drop‑down list with predefined entries. In the sample, public and secret are listed.

• defaultValue: the value shown by default (here: public).

• labels: the label displayed to the user. Multiple languages are supported.

Moreover, the sample file contains an optional Sender Note field.

"name": "sendernote",
          "mandatory": false,
          "maxLength":80,
          "defaultValue":"",
          "labels": {
            "it": "Nota del mittente",
            "en": "Sender note"

Where:

• name: the ID of the metadata field.

• mandatory:

  • false → the field is optional.

• maxLength: maximum number of characters the user can enter.

• defaultValue: the initial value shown in the field (empty in this case).

• labels: field label displayed to the user in the supported languages.