4. Serving content in multiple languages

4.1. Basic concepts

django CMS has a sophisticated multilingual capability. It is able to serve content in multiple languages, with fallbacks into other languages where translations have not been provided. It also has the facility for the user to set the preferred language and so on.

4.1.1. How django CMS determines the user’s preferred language

django CMS determines the user’s language the same way Django does it.

  • the language code prefix in the URL
  • the last language the user chose in the language chooser (cookie).
  • the language that the browser says its user prefers

It uses the django built in capabilities for this.

4.1.2. How django CMS determines what language to serve

Once it has identified a user’s language, it will try to accommodate it using the languages set in CMS_LANGUAGES.

If fallbacks is set, and if the user’s preferred language is not available for that content, it will use the fallbacks specified for the language in CMS_LANGUAGES.

4.1.3. What django CMS shows in your menus

If hide_untranslated is True (the default) then pages that aren’t translated into the desired language will not appear in the menu.