FOLIO front-end code uses translation keys to fetch actual text in English or any other language.

This allows to change the translations after a module has been installed. The most common use case is to backport the latest translations into a FOLIO installation.

A FOLIO release like Honeysuckle, Iris, etc. ships with the translations that come with each front-end module. Each front-end module has a different release date (Honeysuckle example). This is the time when translations are taken from module's GitHub translations directory and is different for each front-end module. A new front-end module release is needed to get more recent translation included into a FOLIO release.

However, the sysOp of a FOLIO installation may manually update the translations of their installation by exchanging the files in the /translations/ directory from where the static files are shipped.

One option is to take the latest translations from .


Do to it manually use the browser developer tools to find out the current number folio-testing uses, for example If you own installation has de-1601343197440.json merge them: jq -s '.[0] * .[1]' de-1601343197440.json de-1605513539114.json >
Then use the joined file: mv de-1601343197440.json


To do it automatically use this script:


# Before running this script change into the ./translations directory where the web server (nginx, ...)
# ships the /translations/*.json files from, for example
# cd /usr/folio/folio-testing-platform/output/translations

set -e

for FILE in ./*-*.json ; do
  if [ ! -e "$FILE" ] ; then
  LANG=$(echo "$FILE" | sed -n -E '/^.\/([^-]+)-[0-9]+\.json$/{s//\1/p;q}')
  if [ -z $LANG ] ; then
  if wget "$URL" -O $LANG.json; then
    echo "$URL"
    echo "failure, skipping $URL"
  jq -c -s '.[0] * .[1]' $FILE $LANG.json > $
  mv $ $FILE
  rm $LANG.json

To remove new translation keys replace
'.[0] * .[1]'
'.[0] as $old | .[0] * .[1] | with_entries( select( .key as $key | $old | has( $key ) ) )'
but this may remove a key that the old code uses and was forgotten to get added to the old language file.

Clean backport using yarn build

The backport method described above is a hack.

The clean way to use more recent translations is to replace them during the front-end build process.

After running yarn install but before running yarn build copy the new translations into the node_modules/@folio/${application}/translations/ui-${application}/${locale}.json files.

We don't know of anyone that uses this method, no script is available for this yet.