Advanced Metadata Field Configuration

This page covers the advanced options for metadata field configuration beyond what is covered in Configuring Metadata Fields, Basic Metadata Field Configuration, and Indexing.

IPTC Equiv.

When using the built in PHP IPTC functionality (i.e. when NOT using ExifTool) this defines the mapping of IPTC keywords to this field. See Metadata Read/Write Mapping for more information.

Display template

Allows alternative HTML to be used for the resource view page. See the default 'caption' field for an example. Leave blank to use the normal display for this field.

Value filter

Allows the transformation of $value with a php code snippet, which will modify the display of a field value in search display fields, Resource View, and contact sheet text. Useful for transforming number options into words, rearranging or reducing comma-separated lists, or modifying date format and such.

Tab name

Allows fields to be split over multiple tabs. Leave blank to disable the tab functionality. If you do use tabs you must provide a tab name for EVERY field and the fields must be ordered so that the fields of the same tab are next to each other, otherwise multiple tabs will appear for a given tab name.

Smart theme name

Automatically generate a Smart Theme section on the themes page based on the data stored for this field. "Fixed" metadata types only, so that means checkbox / dropdown / category tree types. See Customising Types and Fields#Smart_Themes

ExifTool field

When using ExifTool, configures the mapping between XMP/IPTC/Exif etc. metadata and this field. Many different metadata formats and file formats are supported. See Metadata_Read/Write_Mapping

FITS field (v8.3 +)

FITS (File Information Tool Set) is the library ResourceSpace can use to extract technical metadata from different types of files. It requires JAVA to work (at least version 1.7). For more information please go to FITS (File Information Tool Set).

Please note: FITS will overwrite any metadata extracted by ExifTool.

Anyone setting these will have to be aware of FITS XML output in order to be able to map these correctly. For example, the admin wants to map the bitRate to a field, this is how FITS mappings might look: video.bitRate. The more complex setting is when some metadata are under more levels deep (e.g: bitRate which can be found under either video/bitRate OR video/track of type video/bitRate OR video/track of type audio/bitRate) in which case we set a rule like video.track[@type="video"].bitRate.

ExifTool filter

PHP code to modify extracted exiftool $value upon import into the database. You have to be careful about this, since some metadata fields will be looking for specific values upon writeback. It can be used to modify incoming data (changing words, etc.). By default, it is used to translate filesize in the File Size field to bytes, so that that field can be sorted consistently. In the case of filesize, this modified value doesn't actually write back via exiftool since it is simply a property of the file.

Help text

If specified, this text will appear in a box under the field when the field has focus. For checkbox fields and other fields that do not have focus functionality the help box will always appear.

Display as dropdown

Display as a dropdown on Advanced Search.

External user access

When sharing using an external share (no login needed, and a '&k=' value in the shared URL), should this field be displayed?

Autocomplete macro

PHP code that is executed to produce a default value.


  • Setting the expiry date (or any date time field) 3 years in the future from now.
  • return date('Y-m-d H:i', strtotime('+3 year'));

Hide when uploading

Allows the field to be hidden on the resource upload form only, and still be displayed elsewhere such as the edit and view screens.

Hide when restricted

Specifies that the field should be hidden when access to the resource is 'restricted' for the current user.

Omit when copying

Specifies that the field should not be copied when using the resource copy function.

Sync with field

The ID of another field. When the field with this ID is updated, its field settings are copied to this field. This allows for several fields that are the same (e.g. in different resource types) to be kept synchronised. Note that a few options are deliberately not copied - resource type, order by and tab name (to allow independent positioning) and also this sync setting.

Display condition

This means that a field will only appear if a certain condition is met. This field can still be set to 'required' and will just be exempted from the check if the display condition is not met. As an example: 'shortname=value1|value2' or 'shortnamea=validoptiona;shortnameb=validoptionb1|validoptionb2'. A real world example would be for a 'region' field, which would only be displayed if a field with the shortname 'product' was set to 'DVD' or 'Blu-Ray'. i.e. 'product=DVD|Blu-Ray'.