Metadata Import Configuration

Nomad Media can automatically extract and import metadata from various embedded sources during asset processing. This guide covers configuration for EXIF, ID3, video metadata, and document properties.

📘
Mapping Configuration Reference
All metadata import methods use the same mapping configuration model. See the Metadata Mapping Reference for detailed information about:

Mapping properties (sourceKey, customMetadataProperty, createNewContentRecord, splitByDelimiter)

Special target properties (tags, collections, language, dates)

Tag auto-creation behavior

Value splitting with delimiters

Type validation and conversion

Lookup resolution

Error handling

Overview

All metadata import configurations follow the same pattern:

Define import mappings in system configuration
Each mapping specifies a source key and target property
Metadata is extracted during asset processing
Values are validated and converted to match target field types
Special fields (tags, collections, language) are handled automatically

EXIF Metadata Import (Images)

Extract metadata from image files (JPEG, TIFF, PNG, etc.) using EXIF data.

Configuration Location

Add to system configuration at: application/exifMetadataImportSettings

Example Configuration

"application/exifMetadataImportSettings": {
  "importMappings": [
    {
      "sourceKey": "Make",
      "targetProperty": "cameraMake",
      "createNewContentRecord": false
    },
    {
      "sourceKey": "Model",
      "targetProperty": "cameraModel",
      "createNewContentRecord": false
    },
    {
      "sourceKey": "Keywords",
      "targetProperty": "tags",
      "createNewContentRecord": true,
      "splitByDelimiter": ","
    },
    {
      "sourceKey": "DateTimeOriginal",
      "targetProperty": "createdDate",
      "createNewContentRecord": false
    },
    {
      "sourceKey": "Artist",
      "targetProperty": "photographer",
      "createNewContentRecord": false
    },
    {
      "sourceKey": "Copyright",
      "targetProperty": "copyrightInfo",
      "createNewContentRecord": false
    }
  ]
}

Common EXIF Fields

EXIF Field	Description	Data Type
`Make`	Camera manufacturer	String
`Model`	Camera model	String
`DateTimeOriginal`	Original capture date/time	DateTime
`Keywords`	Keyword tags	String Array
`Copyright`	Copyright information	String
`Artist`	Creator/photographer	String
`ImageDescription`	Image description	String
`GPSLatitude`	GPS latitude	Number
`GPSLongitude`	GPS longitude	Number
`Orientation`	Image orientation	Number
`ExposureTime`	Exposure time	String
`FNumber`	F-number/aperture	Number
`ISO`	ISO speed	Number
`FocalLength`	Focal length	Number

ID3 Metadata Import (Audio)

Extract metadata from audio files (MP3, M4A, FLAC, etc.) using ID3 tags.

Configuration Location

Add to system configuration at: application/id3MetadataImportSettings

Example Configuration

"application/id3MetadataImportSettings": {
  "importMappings": [
    {
      "sourceKey": "TIT2",
      "targetProperty": "songTitle",
      "createNewContentRecord": false
    },
    {
      "sourceKey": "TPE1",
      "targetProperty": "artist",
      "createNewContentRecord": false
    },
    {
      "sourceKey": "TALB",
      "targetProperty": "album",
      "createNewContentRecord": false
    },
    {
      "sourceKey": "TYER",
      "targetProperty": "releaseYear",
      "createNewContentRecord": false
    },
    {
      "sourceKey": "TCON",
      "targetProperty": "tags",
      "createNewContentRecord": true
    },
    {
      "sourceKey": "COMM",
      "targetProperty": "comments",
      "createNewContentRecord": false
    }
  ]
}

Common ID3 Frame IDs

ID3 Frame	Description	Data Type
`TIT2`	Title/Song name	String
`TPE1`	Lead artist/Performer	String
`TPE2`	Band/Orchestra/Accompaniment	String
`TALB`	Album/Movie/Show title	String
`TYER`	Year	String
`TCON`	Content type/Genre	String
`COMM`	Comments	String
`TCOP`	Copyright message	String
`TPUB`	Publisher	String
`TRCK`	Track number	String
`TPOS`	Part of a set	String
`TDRC`	Recording time	DateTime

Video Metadata Import

Extract metadata from video files using MediaInfo. Metadata fields are prefixed with track type (General, Video, Audio).

Configuration Location

Add to system configuration at: application/videoMetadataImportSettings

Example Configuration

"application/videoMetadataImportSettings": {
  "importMappings": [
    {
      "sourceKey": "General - Title",
      "targetProperty": "videoTitle",
      "createNewContentRecord": false
    },
    {
      "sourceKey": "General - Performer",
      "targetProperty": "performer",
      "createNewContentRecord": false
    },
    {
      "sourceKey": "General - Genre",
      "targetProperty": "tags",
      "createNewContentRecord": true
    },
    {
      "sourceKey": "General - Recorded_Date",
      "targetProperty": "recordedDate",
      "createNewContentRecord": false
    },
    {
      "sourceKey": "Video - Format",
      "targetProperty": "videoCodec",
      "createNewContentRecord": false
    },
    {
      "sourceKey": "Audio - Format",
      "targetProperty": "audioCodec",
      "createNewContentRecord": false
    }
  ]
}

Common Video Metadata Fields

Field	Description	Data Type
`General - Title`	Video title	String
`General - Performer`	Performer/Artist	String
`General - Genre`	Genre	String
`General - Recorded_Date`	Recording date	DateTime
`General - Copyright`	Copyright information	String
`General - Description`	Video description	String
`Video - Format`	Video codec	String
`Video - Width`	Video width in pixels	Number
`Video - Height`	Video height in pixels	Number
`Video - FrameRate`	Frame rate	Number
`Video - BitRate`	Video bit rate	Number
`Audio - Format`	Audio codec	String
`Audio - Channels`	Audio channel count	Number
`Audio - SamplingRate`	Audio sampling rate	Number

Document Metadata Import

Extract metadata from document files (PDF, Office documents, etc.) using document properties.

Configuration Location

Add to system configuration at: application/documentMetadataImportSettings

Example Configuration

"application/documentMetadataImportSettings": {
  "importMappings": [
    {
      "sourceKey": "Title",
      "targetProperty": "documentTitle",
      "createNewContentRecord": false
    },
    {
      "sourceKey": "Author",
      "targetProperty": "author",
      "createNewContentRecord": false
    },
    {
      "sourceKey": "Subject",
      "targetProperty": "subject",
      "createNewContentRecord": false
    },
    {
      "sourceKey": "Keywords",
      "targetProperty": "tags",
      "createNewContentRecord": true,
      "splitByDelimiter": ","
    },
    {
      "sourceKey": "Comments",
      "targetProperty": "comments",
      "createNewContentRecord": false
    },
    {
      "sourceKey": "CreatedDate",
      "targetProperty": "createdDate",
      "createNewContentRecord": false
    }
  ]
}

Common Document Properties

Property	Description	Data Type
`Title`	Document title	String
`Author`	Document author	String
`Subject`	Document subject	String
`Keywords`	Document keywords	String
`Comments`	Document comments	String
`CreatedDate`	Creation date	DateTime
`ModifiedDate`	Last modified date	DateTime
`Company`	Company name	String
`Category`	Document category	String

Metadata Import Configuration

Mapping Configuration Reference

Overview

EXIF Metadata Import (Images)

Configuration Location

Example Configuration

Common EXIF Fields

ID3 Metadata Import (Audio)

Configuration Location

Example Configuration

Common ID3 Frame IDs

Video Metadata Import

Configuration Location

Example Configuration

Common Video Metadata Fields

Document Metadata Import

Configuration Location

Example Configuration

Common Document Properties

See Also