> For the complete documentation index, see [llms.txt](https://docs.navigaglobal.com/naviga-photos/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.navigaglobal.com/naviga-photos/1.1.1-2/admin-guide/configuration/metadata.md).

# Metadata

### File

Configures which metadata fields from the file that can be added or edited in the user interface. 

Consists of an array of objects. Each object corresponds to a single metadata field from the file. 

If both xmp and iptc are specified, xmp will be used if a value exist in the file, otherwise it will fall back to the iptc value. 

If neither xmp or iptc is specified, an empty field will be rendered. This is useful for adding custom metadata that is not present in the file.

{% hint style="warning" %}
Only changes within the standard metadata fields is part of the downloaded photo. 
{% endhint %}

[Allowed xmp-tags](/naviga-photos/1.1.1-2/admin-guide/configuration/metadata/xmp.md)

[Allowed iptc-tags](/naviga-photos/1.1.1-2/admin-guide/configuration/metadata/iptc.md)

| Key               | Type    | Description                                                                                                                 |
| ----------------- | ------- | --------------------------------------------------------------------------------------------------------------------------- |
| labelName         | string  | The label shown in the user interface                                                                                       |
| xmp               | string  | The name of this metadata in the xmp data of the file                                                                       |
| iptc              | string  | The name of this metadata in the [iptc](/naviga-photos/1.1.1-2/admin-guide/configuration/metadata/iptc.md) data of the file |
| rows              | number  | The height of the edit field shown in the user interface                                                                    |
| mapToMetadataName | string  | The name of the field that will be used to save this metadata in OC                                                         |
| required          | boolean | Should entering a value be required in the user interface                                                                   |

#### Example:

```
[
        {
                "labelName": "Original image photographer",
                "xmp": "dc:creator",
                "iptc": "Byline",
                "rows": 1,
                "mapToMetadataName": "photographer",
                "required": false
        },
        {
                "labelName": "Photo credit",
                "xmp": "photoshop:Credit",
                "iptc": "Credit",
                "rows": 1,
                "mapToMetadataName": "credit",
                "required": false
        },
        {
                "labelName": "Instructions",
                "xmp": "photoshop:Instructions",
                "iptc": "SpecialInstructions",
                "rows": 2,
                "mapToMetadataName": "instructions",
                "required": false
        },
        {
                "labelName": "Object name",
                "xmp": "dc:title",
                "iptc": "ObjectName",
                "rows": 2,
                "mapToMetadataName": "objectName",
                "required": false
        },
        {
                "labelName": "Source",
                "xmp": "photoshop:Source",
                "iptc": "Source",
                "rows": 2,
                "mapToMetadataName": "source",
                "required": false
        },
        {
                "labelName": "Description",
                "xmp": "dc:description",
                "iptc": "Caption",
                "rows": 10,
                "mapToMetadataName": "text",
                "required": false
        },
        {
                "labelName": "Copyright",
                "xmp": "dc:rights",
                "iptc": "CopyrightNotice",
                "rows": 1,
                "mapToMetadataName": "copyright",
                "required": false
        },
        {
                "labelName": "Alt text",
                "rows": 3,
                "mapToMetadataName": "altText",
                "required": false
        }
]
```

### Concepts

Configures which concept types that can be added or edited in the user interface.

Consists of an array of objects. 

| Key     | Type             | Description                                                            |
| ------- | ---------------- | ---------------------------------------------------------------------- |
| label   | string           | The label shown in the user interface                                  |
| title   | string           | The text used in the concept search input. "Search {title}"            |
| rel     | string           | The relation type                                                      |
| filters | array of objects | An object has a single key, "ConceptImTypeFull" with the concept type. |

#### Example:

```
[
    {
        "label": "Author",
        "title": "author",
        "rel": "author",
        "filters": [
            {
                "ConceptImTypeFull": "x-im/author"
            }
        ]
    },
    {
        "label": "Tags",
        "title": "tags",
        "rel": "subject",
        "filters": [
            {
                "ConceptImTypeFull": "x-im/person"
            },
            {
                "ConceptImTypeFull": "x-im/organisation"
            },
            {
                "ConceptImTypeFull": "x-im/topic"
            }
        ]
    }
]
```

###