JSF UI Framework

How to Upload Labels Translations in Nuxeo Studio (i18n)

The Nuxeo Platform relies on standard i18n principles for translating texts in the user interface. You need to upload a .properties file, suffixed with a four letter locale code depending on the language you target. Studio enables to upload properties files that will be deployed with the customization plugin. It can be useful:

  • To translate new labels that appear in the plugin, such as form's fields name, lifecycle transition names, document type names, new vocabularies' labels, etc
  • To override existing labels definitions (when you want to change existing translations).

There is no naming rules for i18n keys: you can use the key format that is most convenient for you and use it directly in the .properties file.

To upload english translations for your plugin:

  1. Prepare a properties file named messages_en_US.properties with keys and label values like this one. For instance, if you have a document type called "ProfessionalServiceProposal", you can put add the following line in the file: ProfessionalServiceProposal = Professional service proposal Example :
  2. Go to Resources and upload the file in the i18n files section.
  3. You can do it again with other languages, adding other files: messages_fr_FR.properties (French), messages_es_ES.properties (Spanish), messages_ar_SA.properties (Arabic), ... (take a look at How to Translate Nuxeo for a list of all the codes available)
  4. Update your Nuxeo instance with your Studio customizations.
5 months ago manonlumeau Relocated assets to fit new URL structure for 710 - fix
4 years ago Anahide Tchertchian 18 | emove warn about server restart: message bundles hotreload does work correctl
5 years ago Solen Guitter 17
5 years ago Manon Lumeau 16
5 years ago Manon Lumeau 15
5 years ago Alain Escaffre 14
6 years ago Solen Guitter 13
6 years ago Laurent Doguin 12
6 years ago Solen Guitter 11 | Added note on i18n key naming rules (no rule)
8 years ago Solen Guitter 9
8 years ago Solen Guitter 10 | Migrated to Confluence 4.0
8 years ago Arthur Gallouin 8
8 years ago Arthur Gallouin 7
9 years ago Darcy Carrié 6
9 years ago Stéfane Fermigier 5
9 years ago Solen Guitter 4
9 years ago Alain Escaffre 3
9 years ago Alain Escaffre 2
9 years ago Alain Escaffre 1
History: Created by Alain Escaffre

We'd love to hear your thoughts!

All fields required