IPTC injection in downloadable files


Infradox XS 26 - all versions

Last change

21 January 2016 Version 27 - supplier macro 

Related articles

The metadata repository


Starting with version 26, you can configure whether or not you want to inject IPTC data into the downloadable files, and which fields or fixed values you want to inject. The data is injected when a user downloads a file from your website. When you add files to the system, the embedded data is read and then inserted into the database. As such, the original embedded data (XMP or IPTC) may be out of date if you use the website to change the data of your files or if you have configured processing rules that change the data (e.g. with Datamatic). With IPTC injection enabled you are always sure that the up-to-date information is available in the downloaded files.

To learn more about IPTC, please visit http://www.iptc.org/standards/photo-metadata/


  • IPTC injection applies to images only
  • IPTC injection does not support localisation
  • Certain IPTC/XMP software may not show all of the embedded fields


To configure IPTC injection, go to Site configuration and click IPTC injection in the bar on the left.  The page will show the embedded fields that you can update. 

Select the database field in the dropdown box from which you want to the value to be injected. The dropdown boxes in the "fixed value option" let you choose to Replace, Append or Prepend a fixed value.

As an example, if you want to inject the supplier name followed by your company name as a fixed value - into the field dc_rights, then select Credit in the database field dropdown, select Append in the dropdown next to it, and then enter your company name in the fixed value input box. 

Note that if you append a fixed value to the data that is retrieved from a selected database column, a space will be added before the fixed value. If you prepend a fixed value, a space will be added after the fixed value.

You can also choose to inject only a fixed value without data from any field. In that case, make sure to select the value * None * in the database field dropdown, and enter the fixed value that you want to inject in the input box.

You can also use so-called macros in the fixed value fields as described below. 


  • [ordernr]
    Inserts the order id of the order from which the file is downloaded
  • [userid]
    Inserts the user id 
  • [useremail]
    The e-mail address of the user
  • [username]
    The user's first and last name
  • [useripaddress]
    The user's ip address
  • [websiteaddress]
    Your website address
  • [previewpageurl]
    A URL where the file and its data can be viewed (preview page)
  • [dd]
    Today's day number
  • [mm]
    Today's month number
  • [yy]
    Today's year number

Example macros

  • Downloaded on [dd]-[mm]-[yy] by [username] from [useripaddress], order id [orderid] 

Supplier macro

In version 27 a new macro has been added to output the supplier name, and/or supplier group. This works the same as is described in the article about displaying supplier names on the client facing pages.

  • [supplier_name]
    Name of supplier (e.g. photographer name)
  • [supplier_group]
    Name of group in which the supplier exists (e.g. agent name)
  • [sep]
    Separator as defined with [sep=] - for example [sep=/] will output a slash (/) where you use [sep]. Use this code as opposed to a hard coded separator to prevent duplicate names (read the article about displaying supplier names for further information).
  • [sep=/] 

Supplier macro example 


  • [supplier_name][sep][supplier_group][sep]Best Images [sep= / ]
    Outputs e.g. John Doe / Super Photos / Best Images





Have more questions? Submit a request


Article is closed for comments.
Powered by Zendesk