Content (Multilingual)

Last Updated: Sep 21, 2023
documentation for the dotCMS Content Management System

To add a new version of content in a new language, open the content from the Content Search tab and select the language from the language dropdown in the top left corner.

Selecting a New Content Language

The first time you create a version of content in a new language, you'll be prompted to choose if you want to populate the content from the existing content in another language. To preserve the placement of links, images, files and other references in the content, choose Yes.

Language Population Prompt

Previewing Content by Language

To preview content in a specific language, go to the Site Browser and open a page that displays the content. Change the display language for the page, and the content pulled by the page will be displayed in the selected language.

Previewing Content in Multiple Languages

Deleting Multilingual Content and File Versions

*Warning - Deleting content versions is not recommended since Archiving the content should normally be sufficient and removes the content version from the default Content Tab view.
However, as of the dotCMS 3.7 version, specific language versions of a contentlet may be deleted without deleting the entire contentlet. To completely delete a specific language version of a contentlet or file, use the following steps:
1) From the Content tab, choose the All option for languages, find the specific language version of the content you wish to delete, select it, and then click the “Unpublish” button below. Select the same content language version again, but now click on the Archive button.

2) The archived content language version is no longer visible. To fully delete the language version, choose the “Show” filter and select “Archived”. Find the language version of the content you'd like to permanently remove, and click on the “Delete” button. The specific language version is permanently removed, but the other language versions from the same contentlet/file remain and are unaffected.

Pulling Content in the Default Language

Whenever a page is displayed in a specific language, all content on the page that exists in the chosen language will be displayed. However dynamic pages can (and should) be built to pull a default language version of content if there is not a version of the content that matches the front end user's language choice on a particular page. In addition, dotCMS system properties can be configured to automatically display the version of content in a default language if versions do not exist in the current display language (regardless of the page configuration).

For more information on configuring dynamic pages to pull default language versions of content see the Building Multilingual Sites documentation.

For more information on configuring dotCMS system properties to pull default language versions of content see the documentation on configuring languages, default languages, and pulling multilingual content.

On this page


We Dig Feedback

Selected excerpt: