Import files

Click the 'Add files ...' button on the toolbar: the round button with + sign:

A dialog window pops up, allowing you to select the files to add. The type of files allowed to select depends on the batch type:

  • For Creative and Editorial Images: 'JPG'
  • For Video: 'MOV'
  • For Illustrations: 'EPS' and 'JPG' (either just JPG: rasters, or EPS/JPG combinations, where JPG is then the thumbnail)


  • Use CMD (on Mac) or CTRL (on Windows) keys to select multiple individual files in the list.
  • Use SHIFT key to select a range of consecutive files in the list.

If found in the EXIF or IPTC metadata of your JPG files, the 'title', 'description' and 'keywords' will automatically be imported.

Note that DeepMeta will access the Getty ESP/Contribute server during this process, if keywords are imported from the JPG file. The reason is that Getty does not accept any random keyword, but requires these to be conform to the Getty Images CV (Controlled Vocabulary). This data must be fetched by DeepMeta for each group of new keywords added.

After selection of the files and hitting the 'Open' button, the status bar at the bottom will show the progress:

You can continue doing other things in DeepMeta while the import takes place. To see the progress/result of adding files, select 'History' in the left-hand section list:


'Illustrations' get a special treatment. There are 2 types:

Raster Illustrations

These are JPG files, added to a Batch of type 'Illustration'. Just add the JPGs as you would with regular images. Their presence in an 'Illustration' batch marks them as illustration.

Vector Illustrations

These are combinations of 2 files each: an 'EPS' file for the actual vector and an accompanying 'JPG' for the thumbnail. Important: these 2 files must have the exact same filename (except for the extension): e.g. 'Background28.eps' and 'Background28.jpg'. If this is not the case, they will not be recognized as an illustration/thumbnail combo. After adding the files, it's a good idea to go to the 'History' panel and check if the files were properly linked:

The newly added images appear in the DeepMeta File list, with status 'To Edit', which means that their metadata (title, description and keywords) now need to be entered/verified. Only after that, you'll be allowed to upload the file to Getty/Contribute.

Drag and Drop

As an alternative to using the 'Add files' button as described above, you can also simply drop files from the Finder (macOS) or File Explorer (Windows) onto the DeepMeta window. They will be added to the active batch:

Import metadata from CSV file

DeepMeta supports metadata import from CSV files. When adding files to DeepMeta, select the CSV file as well, and it will be parsed for metadata, which is then applied to corresponding files. It is even possible to specify Model or Property releases to be linked to the files.

Requirements for the format of CSV files is the same as on the ESP site: it's a plain text file with ".csv" extension, with the first line containing the exact names of the fields (order is not important). Each following line contains comma-separated metadata for the file with its name in the "file name" column.

For the keywords column: use commas to separate the keywords and place the entire keyword string between double quotes. Alternatively, you can separate the keywords with the | character, and then no extra double quotes are needed. You can leave fields empty for which you don't have metadata, like typically for "creation date", which is normally extracted by DeepMeta from the file itself. Possible columns for each type of file are as follows:

  • Creative Image: file name,created date,description,country,brief code,title,keywords
  • Editorial Image: file name,created date,description,country,title,personalities,keywords
  • Creative Video: file name,keywords,description,title,country,poster timecode
  • Creative Illustration: file name,description,country,title,keywords,color Wildcards in filenames are supported: if "*" specified in the FileName column, then the data from that line will be used for all files that don't have a matching filename in the CSV file. Handy for assigning e.g. the same release to all imported files.

You can download an example CSV file for Creative Image files.

A few words on local copies of added file

By default, DeepMeta makes a copy of your added files to its local data folder until uploaded.

If you don't want DeepMeta to create a local copy of the file until it's uploaded, you can specify this in the 'File handling' section of the Preferences window.

Particularly for video files, which take up a lot of disk space, you may want to prevent DeepMeta from making a temporary copy. Note that this means you should leave your original JPG/EPS/MOV file in the same place until it is uploaded.