The metadata repository


Infradox XS - all versions

Related articles

Configuring how photographer names / credits are displayed

Search filters

Uploads by suppliers and the submission queue

Adding keywords from similar files

IPTC injection into downloadable files


Article updates

  • 24 February 2016 - sorting field order and quickly selecting fields for dialogs and client facing pages
  • 23 October 2015 - added information about displaying photograher names on different pages
  • 19 May 2015 - explanation of the data properties field
  • 15 April 2015 - configuring a field for supplier matching
  • 3 April 2015 - text transformation and field value colors
  • 16 January 2015 - contributor related changes


The metadata repository holds information about the fields that are available to describe your files, and how and where these fields appear on the client facing pages, in the edit dialogs and on the upload pages. You can also configure certain fields to be used for certain media types only (e.g. only for footage). The list shows fields that are IPTC / XMP compatible, the system fields, and a number of so called custom fields. 

To be able to view or change the metadata repository, you must be logged in with the Super administrator account or any other administrator account with Site configuration permissions.

Selecting fields and changing the order of display

In version 27.2 we've added three buttons to the toolbar that will allow you to (which drag & drop) easily 

  • select which fields to display on the IPTC tab and on the Custom tab - in both the administrator and supplier/contributor edit dialogs
  • make fields hidden if you don't want to use those fields in either the administrator and/or the supplier/contributor edit dialogs
  • make fields hidden if you don't want to use those fields on the client facing pages
  • change the display order of fields

Click the toolbar button to open the dialog and simply drag and drop the fields. Change the order of display by dragging and dropping a field to a different position in the same box (e.g. IPTC, Custom or Hidden).

*** In version 27.3 or later, you can only change the sort order of fields, which fields to display and where to display the selected fields - with the toolbar buttons described above.

Configuring the fields

Go to Site configuration and click Metadata repository to load the fields list. At the top of the page you can filter the fields that are being displayed. You can also enter the name of a field (in the toolbar) to make it easier to find the field that you are looking for. Once you have located the field that you want to change, click its row in the list. This will open the properties dialog.

  • Changing the label that appears on the client facing pages
    Enter a text in the Website label box. If you want to use different languages then enter these separated by commas in the correct order. 
  • Media type
    As a default, all the fields are available for all types of content (the setting is Any). To restrict a field to content of a specific type only, change the Media type dropdown. If you for example select Footage this means that the field will not show if the file is of any other type than footage. 
  • Selecting if the field is displayed on the client facing pages
    * 27.3 or later: use the toolbar buttons to change this property
    The Show on website dropdown allows you to hide the field from the client facing pages. Note that you can also hide fields that are indexed and searchable, e.g. if a field contains synonyms that you want to be searchable but not visible. You can also make a field show only if the user is logged in with an administrator account.
  • Hide label if the field has no value
    To make a field and its label show only if it has a value, check this option. 
  • Search link
    If a field is used to store values that can be used to search, you can check this option. The field value will show as a link that can be clicked to start a new search.
    From 26 onwards, you can also link the credit field to the contributor's profile or link the credit field to the "contributor browsing" function. The latter will use a special function to load the contributor's photos (not by means of executing a search for the credit value).
  • Display order
    * 27.3 or later: use the toolbar buttons to change this property
    This dropdown allows you to change the order in which fields appear on the client facing pages (i.e. the preview page and the order and download pages). A custom sort order must be enabled separately.
    - To enable this function for the Preview pages, go to Site configuration, General settings, and open the Preview pages section. Next, check the box Use the Metadata repository field display order
    - To enable this function for the Cart pages, go to Site configurationCart page, and open the Cart page settings at the top to change the setting.
    - To enable this function for the Order / Download pages, go to Site configurationDownload page, and open the Download page settings at the top to change the setting.
  • Field value display color (version 26.1 and later)
    You can choose a display color for each individual field. More information further down in this article.
  • Text transformation (version 26.1 and later)
    You can choose a text transformation option, i.e. unchanged, uppercase, lowercase, capitalize and capitalize with the exception of words in all caps. More information further down in this article.

Uploader data source

The list shows a column for the http uploader data source. If data for a field is read from a file's embedded data (i.e. Photoshop, IPTC, XMP) this column will show the source. When you upload a file using the HTTP uploader - or in any case through the holding area - embedded data is read from the file and then written to an XML file. This XML file is the so called "sidecar file". The data that you can see in the fields on the uploader pages is the data that is read and saved to the aforementioned sidecar file. If you have configured fields to be showing on the uploader pages, then the person uploading the file still has a chance to edit that data before finally submitting the file to the processing queue. Editing the data will update the sidecar file. The data that's stored in the sidecar file is the data that will be used during processing and as such the data that will be inserted into the content database. 

These are the fixed mappings:

  • cot_headline > photoshop_Headline (iptc Headline)
  • cot_byline > dc_creator (iptc By-line)
  • cot_objectname > dc_Title (iptc Object Name)
  • cot_credit > photoshop_credit (iptc Credit)
  • cot_copyright > dc_Rights (iptc Copyright Notice)
  • cot_caption > dc_Description (iptc Caption/Abstract)
  • cot_category > photoshop_Category (iptc Category (deprecated))
  • cot_subcategory > photoshop_SupplementalCategories (iptc Supplemental Category (deprecated))
  • cot_keywords > dc_Subject (iptc Keywords)
  • cot_creationdate > photoshop_DateCreated (iptc Date created)
  • cot_creationtime> (derived)
  • captionwriter > photoshop_CaptionWriter (iptc Writer/Editor)
  • cot_custom1 > photoshop_Country (iptc Country/Primary Location Name)
  • cot_custom2 > photoshop_City (iptc City)
  • cot_custom3 > photoshop_Source (iptc Source)
  • cot_custom4 > photoshop_Instructions (iptc Special instructions)
  • cot_custom5 > iptc4xmpCore_CountryCode (iptc Country/Primary Location Code)

Note that you can not change these mappings for the http uploader. If you have Datamatic however, it is possible to create processing rules that for example move data from one column to another.

Changing the field properties for the administrator and supplier dialogs

  • Editor label
    The editor label is the name of the field that is displayed in the edit dialogs. You can specify a different label then the one that's used on the client facing pages if you wish.
  • Input style
    Normal fields should be configured to use the Input box option and text fields such as keywords, caption, category and subcategory should be configured as Text area
  • Property sheet
    This option allows you to change on which of the tab / property sheets the field will appear in the edit dialogs. This allows you to move the fields that you use most to the first tab for easy access. You can also change the order in which fields appear by changing the values in the dropdown box.
  • Allowing fields to be changed
    Certain fields may have values that are imported from the metadata or have information that may not be changed once the file is in the database. To prevent changes in such fields, untick the Editable checkbox.
  • Making fields required
    If you want information to be entered in a field always, then check the Required checkbox. The user will not be able to save a file's properties without entering information in all the required fields.
  • Hiding fields from the administrator's edit dialogs
    If there are fields that you don't use or don't want to appear in the dialogs for other reasons, then uncheck the option Show in admin dialogs.
  • Hiding fields from the supplier editing dialogs
    If there are fields that you don't want to appear in the supplier editing dialogs (requires the supplier editing module), then uncheck the option Show in supplier editor dialogs.
  • Hiding fields from the batch editing dialogs
    Untick the option Show in batch edit dialog, to prevent a field from appearing in the batch edit dialog. This option should be used to prevent certain fields from being changed with a batch update command. Use this for fields containing unique values such as the creation date- and time or object name. But also for other fields, for example if the original file name is copied to one of the custom fields (as part of the file ingestion procedures), then hide that field from the batch editing dialog.
  • Show in upload dialog
    Use this option to hide fields from the data dialogs that appear when uploading files with the HTTP upload function.
  • Contains comma separated values
    This option should be selected for fields that contain words separated by commas, such as the keywords field.

Configuring how photographer names / credits are displayed

To change how photographer names are displayed on different pages, please read this article for more information.

Configuring a field for supplier matching / linking

This setting is available in version 26.1 onwards.

Every file must be linked to a supplier. If you upload files with the HTTP uploader you must select a supplier from the list before you'll be able to submit the file. If your photographers upload files then the system automatically links their files to the correct supplier.

But if you supply files in a different way, the system needs to know how to automatically link the files to the correct suppliers. At the bottom of the Properties tabsheet in the metadata dialog, you'll see a setting Use this field for supplier matching that you need to enable. Note that you can configure only one field in the metadata repository for supplier matching.  Next you can choose whether you want to use the matching action for both inserts and updates or for inserts (i.e. new files) only. You can enter the id of a group (which you must have created in Supplier management first) in which you want suppliers to be created if an existing supplier can't be found. 

It is best to use unique codes (as opposed to names) for supplier matching. However, you can use the credit field or other fields too.

Linking a field to the controlled vocabulary

To link a field to the Controlled vocabulary (CV), click on the vocabulary tab and check the box  Link field to the Vocabulary. You now have the following options:

  • Allow free text entry
    Select this option if you want to be able to both add text by simply typing into the input box and to enable the lookup function for words in the CV. If only words that are in the CV are allowed, then disable the free text option.
  • Allow multiple values
  • Close on click
  • Add the full hierarchy for each term
  • Include the top level name
  • From root or from selected entry point

Field value colors and text transformations

Version 26.1 and later allow you to select a display color for field values - and you can select a text transformation option. The selected color code will be added as in-line CSS in the HTML pages. Note that you can also display all or certain fields by applying your own CSS.  

To transform a field's value, you can select any of the options Uppercase, Lowercase, Capitalize and Capitalize except words in all caps. If you use the Capitalize option then each word will start with an uppercase letter followed by the rest of the word in lowercase. The option Capitalize except words in all caps does the same thing, but it doesn't change words that are in uppercase. 

Text transform examples for the keyword value: central africa, NGO, aid, Emergency

  • Lowercase > central africa, ngo, aid, emergency
  • Capitalize > Central Aftrica, Ngo, Aid, Emergency
  • Capitalize except words in all caps > Central Aftrica, NGO, Aid, Emergency

The data properties field

Field custom18 is reserved for the file data properties. These properties are (among other things) used to create filters. For further information about how the codes are used to generate search filters, read the article about filters and gallery access control.
You can also use the properties field to create so called conditions in your syndication configuration.

The properties field can contain any of these properties and values:

  • CC=1 color
  • CB=1 Black & White
  • MR=1 Model released
  • PR=1 Property released
  • NSFW=1 Not Suitable for Work (e.g. nudity or offensive content)
  • MT=0 Image, MT=1 Video, MT=2 PDF, MT=3 Document, MT=4 Audio, MT=5 Other/unknown
  • BR=1 Blocking restriction
  • NB=1 Non-blocking restriction
  • BI=1 Block immediate delivery
  • NS=1 No syndication
  • BX=1 Block 3rd party API access
  • BA=1 Block agents
  • PS=1 Available for print sales
  • PG=0 to PG=9 Pricing group 0 to 9
  • CDR=1 Contributor delete request (contributor wants the file removed)
  • ED=1 Editiorial only
  • CR=1 Creative/Commercial
  • ITI=1 Image type Illustration
  • HIDE=1 Hide from search results
  • LR=1 Only available as Low resolution file
  • OH=1 Orientation Horizontal
  • OV=1 Orientation Vertical
  • OS=1 Orientation Square
  • OP=1 Orientation Panoramic









Have more questions? Submit a request


Article is closed for comments.
Powered by Zendesk