Language Macros
Language macros are used to fill in translations supplied by your team. They don’t magically create translations. Of course, you can insert your original text in DeepL or Google Translate to speed up the translation process. But you’ll still have to insert the translations into the language macros yourself.
Using language macros to translate content
Navigate to a page that needs to be translated. Alternatively, create a new empty page to start from scratch.
Open the macro browser and start typing the first language. Choose the desired language.
Type your respective content into the language box. If you are working with existing text, simply drag your content into the language box. You may use any other macro within the language macro.
Open the macro browser again and start typing another language. Choose the desired language.
Type the translation of your content into the new language box.
Repeat until all languages are covered.
Save the page.
If you want to translate the page title as well, proceed with this instruction: Translate Page Title
Important notes:
Content will appear only in the language selected in your user profile. To view content in other languages, use the language drop-down menu.
When previewing a page with language macros, only content in the language that matches your current profile setting will be displayed.
Translated page titles will not be visible in the preview view.
List of language macros
This is a list of all the languages you can use to translate content into. A pretty impressive collection, right? Still, let us know if you miss any languages. 🙂
English (US) {english-us}
The content of this macro is only displayed if the user’s language setting is English (US).English{ english}
The content of this macro is only displayed if the user’s language setting is English (GB).Belarusian {belarusian}
The content of this macro is only displayed if the user’s language setting is Belarusian (беларуская мова).Bulgarian {bulgarian}
The content of this macro is only displayed if the user’s language setting is Bulgarian (български език).Canadian (English) {canadian-en}
The content of this macro is only displayed if the user’s language setting is Canadian (English).Canadian (French) {canadian-fr}
The content of this macro is only displayed if the user’s language setting is Canadian (français).Catalan {catalan}
The content of this macro is only displayed if the user’s language setting is Catalan (català).Chinese {chinese}
The content of this macro is only displayed if the user’s language setting is Chinese (中文, 汉语, 漢語).Croatian {croatian}
The content of this macro is only displayed if the user’s language setting is Croatian (hrvatski jezik).Czech {czech}
The content of this macro is only displayed if the user’s language setting is Czech (čeština, český jazyk).Danish {danish}
The content of this macro is only displayed if the user’s language setting is Danish (dansk).Dutch {dutch}
The content of this macro is only displayed if the user’s language setting is Dutch (Nederlands).Estonian {estonian}
The content of this macro is only displayed if the user’s language setting is Estonian (eesti).Finnish {finnish}
The content of this macro is only displayed if the user’s language setting is Finnish (suomi).French {french}
The content of this macro is only displayed if the user’s language setting is French (français).German {german}
The content of this macro is only displayed if the user’s language setting is German (deutsch).Greek {greek}
The content of this macro is only displayed if the user’s language setting is Greek (ελληνικά).Hindi {hindi}
The content of this macro is only displayed if the user’s language setting is Hindi (हिन्दी).Hungarian {hungarian}
The content of this macro is only displayed if the user’s language setting is Hungarian (magyar).Icelandic {icelandic}
The content of this macro is only displayed if the user’s language setting is Icelandic (Íslenska).Indonesian {indonesian}
The content of this macro is only displayed if the user’s language setting is Indonesian (Bahasa Indonesia).Irish {irish}
The content of this macro is only displayed if the user’s language setting is Irish (Gaeilge).Italian {italian}
The content of this macro is only displayed if the user’s language setting is Italian (italiano).Japanese {japanese}
The content of this macro is only displayed if the user’s language setting is Japanese (日本語).Korean {korean}
The content of this macro is only displayed if the user’s language setting is Korean (한국어).Latvian {latvian}
The content of this macro is only displayed if the user’s language setting is Latvian (latviešu valoda).Lithuanian {lithuanian}
The content of this macro is only displayed if the user’s language setting is Lithuanian (lietuvių kalba).Malay {malay}
The content of this macro is only displayed if the user’s language setting is Malay (Bahasa Melayu).Maltese {maltese}
The content of this macro is only displayed if the user’s language setting is Maltese (Malti).Norwegian (Bokmål) {norwegian-nb}
The content of this macro is only displayed if the user’s language setting is Norwegian (Bokmål).Norwegian (Nynorsk) {norwegian}
The content of this macro is only displayed if the user’s language setting is Norwegian (Nynorsk).Polish {polish}
The content of this macro is only displayed if the user’s language setting is Polish (jezyk polski).Portuguese {portuguese}
The content of this macro is only displayed if the user’s language setting is Portuguese (Português).Portuguese (Brasil) {portuguese-br}
The content of this macro is only displayed if the user’s language setting is Portuguese (Português Brasil).Romanian {romanian}
The content of this macro is only displayed if the user’s language setting is Romanian (Română).Russian {russian}
The content of this macro is only displayed if the user’s language setting is Russian (русский).Serbian {serbian}
The content of this macro is only displayed if the user’s language setting is Serbian (српски језик).Slovak {slovak}
The content of this macro is only displayed if the user’s language setting is Slovak (Slovenčina).Slovenian {slovenian}
The content of this macro is only displayed if the user’s language setting is Slovenian (Slovenski Jezik).Spanish {spanish}
The content of this macro is only displayed if the user’s language setting is Spanish (español).Swedish {swedish}
The content of this macro is only displayed if the user’s language setting is Swedish (Svenska).Thai {thai}
The content of this macro is only displayed if the user’s language setting is Thai (ไทย).Turkish {turkish}
The content of this macro is only displayed if the user’s language setting is Turkish (Türkçe).Ukrainian {ukrainian}
The content of this macro is only displayed if the user’s language setting is Ukrainian (Українська).Vietnamese {vietnamese}
The content of this macro is only displayed if the user’s language setting is Vietnamese (Tiếng Việt).
i18n of language macros
As of version 4.0.x, the description texts of the language macros are available in the following languages:
German
French
Spanish
Why this matters: If your Confluence is run in German, French or Spanish, you can look for language macros in your mother tongue:
Example: Confluence's language is set to German (Deutsch)
In the editor, type an opening curly bracket and start typing "deut".
Choose the suggestion "Deutsch".
Alternatively, select "Makro Browser öffnen" and type "Sprache" to browse through the entire list of languages.
No worries if you're used to the English version! You can still type "german" and the right macro will be suggested:
Pretty neat, right? We hope you will enjoy using the new translations as much as we do!
By the way, the translations are also effective in the language drop-down.