Back
Blog PostsTranslations for Confluence

Use Confluence in multiple languages with Translations for Confluence

Multilingual Confluence with Translations

Managing multiple languages without a Confluence language app

While Confluence is an invaluable tool for countless editors, there is a recurring issue for international companies: How do you change Confluence language without a Confluence language app? The most frequent workaround we have seen customers use: Editors create various page trees in the same space, one for each language needed. These pages can then be linked. The downside of this approach, other than a huge amount of manual work for the editors:

  • Consistency issues: There is no easy way to ensure that the Confluence content remains consistent. If the original Confluence content changes, how can the Confluence multilingual content spread throughout Confluence be updated as well?
  • Unusable page tree: The page tree is clogged with a multitude of pages, making it harder to browse.
  • Unsatisfactory search results: With many pages listing the same keywords in their content, all language versions are indexed in Confluence search, and it’s hard to find the relevant version.

Managing multiple languages using Translations for Confluence

The app Translations for Confluence (available for Data Center and Cloud) tackles all of these obstacles. Our approach is different: The Confluence multilingual content is created and updated on a single Confluence page (or blog post, for that matter). When users access the Confluence page, only the language version that is relevant to them will be displayed. How is this possible?

The key to this solution is working with Confluence macro language. These are simple macros bearing the name of the language required. Each Confluence macro language can enclose any content and any amount of other macros. The editor is entirely free to choose which language macros to use on any page, among over 40 different languages, allowing for easy Confluence language translation. This helps businesses looking for a Confluence language switcher that works efficiently.

Language macros in the editor

Confluence language settings: Which language is displayed to whom?

The language displayed by Translations for Confluence depends on several Confluence language settings:

  • As an administrator, you can set the language Confluence is displayed in (general configuration).
  • Mostly, it’s advisable to let each Confluence user decide for themselves. They can change Confluence language in their user profile. Their choice will override the general language setting. As a result of their choice, the users will see the page content only in the language they selected.
  • If users still want to see another language on Confluence, they can do so by using the Confluence language switcher drop-down menu. That menu automatically appears on all pages carrying at least one language macro.
Display Confluence in other languages with Translation for Confluence using the language drop-down menu.
Language drop-down to switch languages

What about the page title?

Confluence language settings for page titles on Data Center 

The “Translate title” interface allows you to enter translations for page titles, which is a valuable feature for organizations that need to change Confluence language settings across different regions. After entering the translations, you can publish the page content in your preferred language.

Translate title” overlay within Translations for Confluence

“Translate title” works for both pages and blog posts, making it particularly valuable for social intranets. But most importantly, the page titles are indexed and used by Confluence search as well. The user can simply start typing the title in their preferred language and will see those search results only.

How to use Confluence in multiple languages and display Confluence language in German.
German query – German search results

Confluence language settings for page titles on Cloud

Unfortunately, page titles cannot be translated on Confluence Cloud. However, the Confluence macro languages themselves have the same functionality as on Data Center. This means the following:

  • The page title will remain the same no matter which language setting is chosen on Confluence.
  • The content language of the page is adapted to the user’s settings. It can also be changed using the language drop-down.

If you are a Jira Service Management user, you will be interested to read this blog post on: How to set up a multilingual knowledge base for JSM. Also, read our blog post comparing the different translation solutions available for Cloud and Data Center.


Advantages of the confluence language switcher

Organizations can improve communication and information sharing across global teams by utilizing Confluence language translation. The Confluence language switcher allows users to easily switch between languages and find the content they need, improving user satisfaction and enabling seamless collaboration among team members with diverse linguistic backgrounds. Organizations should consider implementing this feature to improve Confluence language translation and support smoother collaboration.

In a nutshell – what you gain by using Translations for Confluence

  • One page per topic only – no need to cross-reference different language versions.
  • Efficient search – all language versions are indexed and lead to one single page.
  • Flexibility – you decide which pages need to be translated. There is no rigid workflow dictated by the app.

Ready to start creating your Confluence in multiple languages on Data Center or Cloud with Translations for Confluence?

Elevate your Confluence insights! rocket Explore our latest guide to learn how to track usage and measure success on your Confluence pages.