System Language Properties - Documentation topics on: i18n,internationalization,l10n,language properties,languages,localization,multilingual,.

This documentation is a static copy for this version. For current documentation, see:

System Language Properties

A number of system properties define and control how dotCMS displays and handles content in different languages.

Default Language

Each system must define a default language. The default language is configured in the file, via the following properties:

CHARSET = text/html;charset=UTF-8

The standard dotCMS distribution ships with the default language and the values of all these properties set for U.S. English (as in the property values shown above). To change the default language, you must change all of these properties to appropriate values for your location and language.

Language Standards

Where applicable, dotCMS adheres to appropriate ISO standards for country codes and language codes. Specifically:

  • The DEFAULT_LANGUAGE_CODE property is expected to contain a value defined by ISO standard 639-1.
  • The DEFAULT_LANGUAGE_COUNTRY_CODE property is expected to contain a value defined by ISO standard 3166-1 (Alpha-2).
  • The DEFAULT_LANGUAGE property is expected to contain a value equal to the value of the DEFAULT_LANGUAGE_CODE, followed by an underscore (_), followed by the value of the DEFAULT_LANGUAGE_COUNTRY_CODE.

The values of the DEFAULT_LANGUAGE_COUNTRY and DEFAULT_LANGUAGE_STR properties are not expected to conform to any standards, and may include country and language names in any language.

Property File Refresh Frequency

The Language Properties files provide translations of common terms in several languages, which can be used to aid in translating forms, and which are used to translate the dotCMS back-end interface into different languages. By default, dotCMS re-reads the language properties files once every five minutes. To increase or decrease this frequency, modify the LANGUAGES_REFRESH_INTERVAL with the new frequency (in minutes).


For more information on the language properties files, see the Multilingual Forms documentation.

Multilingual Content Pulls

Several additional properties determine how dotCMS behaves when a user attempts to display Pages or Content, but no version of the content exists in the user's display language. For more information see the Multilingual Content Pulls documentation.