+1-757-461-3022 x124

Setting up Locales

What are Locales? And how do they work?

Locales are associated with users and define the format for date, time, and numbers. Locales are also used to search for translation files and to specify decimal precision and some of the colors that the user sees on the screen. You can read more about Locales in the Reference Guide section on Locales.

Info: You need to understand how Locales work if you want to use the translation (.qm) files generated by the Translation Portal. If you do not get the results you expect, it is likely there are problems with your Locale setup. It is also possible you renamed the .qm file you downloaded from the Translation Portal. For best results, you should not rename the translation (.qm) file.

The setup for Locales can be found in the System > Setup > Master Information section of xTuple ERP. The following screen shows a sample list of Locales:

Sample Locales Master List


Two fields on the Locale setup are especially important to consider: Language and Country. Here are some points to remember when you are trying to figure out which Locale settings to use:

  • Language: If you are using a generic language file (i.e., generic French xTuple.fr.qm or generic Spanish xTuple.es.qm), then the language field is the only field you need to set. The country field should remain as "Any" when using generic language files. So, in these examples, you would set the language to either "French" or "Spanish; Castilian" and the country would be "Any."

  • Country: The country setting is important if the language is specific to a particular country. A good example for this is Canadian French. In this case, the language field should be set to "French" and the country field set to "Canada." Accordingly, the translation (.qm) file is constructed differently if the language is specific to a particular country. The following examples illustrate how the .qm files differ for generic French and Canadian French

    • xTuple.fr.qm: This is generic French. Notice how the only indicator is the "fr" in the name. xTuple uses the ISO standard two-letter language codes when it builds .qm files.

    • xTuple.fr_ca.qm: This is Canadian French. Notice how the country indicator "ca" follows directly after the "fr" language indicator. xTuple uses the ISO standard two-letter country codes when it builds .qm files.

Sample Locale for Generic Language


Sample Locale for Country-Specific Language


Finally, once the Locale is defined, you must link the Locale to your system user. To link your user with a Locale, go to System > Maintain Users. Simply select the Locale you want to link to your user from the drop-down list, as shown in the next screenshot:

Linking User to Locale


Info: You must log out/log in before you will see changes to the Locale linked to your user.

98 users have voted.