Configuring Languages

Last Updated: Jul 23, 2020
documentation for the dotCMS Content Management System

Languages must be created and configured in dotCMS before contributors may create and edit content in different languages on your site. The documents in this section discuss the features, configuration properties and tools that allow creation of multilingual sites and content and simplify their management

System Language Properties

A number of language properties, which can be set in the file, allow you to control how languages are handled for all sites on your dotCMS instance.

The Default Language

Each dotCMS instance has a single Default Language, which both controls which language version of content is returned when a request is made without a specified language, and which affects how other language features operate, such as the Default Language Fallthrough Configuration.

For more information on the Default Language, please see the Default Language documentation.

Default Language Fallthrough

You can configure dotCMS to automatically display content in the Default Language when a version of the content does not exist in the user's selected language.

For more information, please see the Default Language Fallthrough Configuration documentation.

Language Property Files 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 please see the Pulling Multilingual Content documentation.

On this page


We Dig Feedback

Selected excerpt: