Learn how to create or delete a translation for a document version.
Translations are created as separate page trees with a language and version prefix and are always associated with a version. Once translations are created, they can be switched to using the picker in the Document toolbox or the Language Navigation Macro.
Translations can only be created for any of the languages defined for a document, so make sure those are set up beforehand.
Before you can add or delete a translation you need to fulfill the following prerequisites:
- You need to have defined an authoring language and an additional language for your document.
- You should have permissions to Edit Version Details in the space.
How to Add a New Translation
Step 1: Navigate to the Document Manager
In order to navigate to the Document Manager you can either:
Click Scroll Documents from the App section in your space sidebar.
From the Document Library, click the document card of a document.
From a page in a document, click Document toolbox and click the cog icon.
Step 2: Add a Translation to a Version
In the Document manager, locate the version you would like to translate.
Select Add translation to bring up the New translation dialog.
- Select which language you would like to translate your content into and press Save, this will add the new translation to your selected version.
Unless you aren’t actively using the versioning feature, we recommend to only add translations to saved versions and keep the Working version in the authoring language only. This makes it easier to separate the authoring and translating process for a smoother work flow.
Options available in the New translation dialog
During the creation of a new translation, you have access to the following options:
Language: Select the language into which you would like to translate the version
Restrictions: Apply restriction to the entire translation page tree. Selecting this option adds an extra step to the dialog.
Prefix: Customize the prefix associated with the selected language
Resolve include page macros: Replace include page macros with the content they are including
How to Delete a Translation
If you want to delete a translation, follow the steps below:
In the Document manager, locate the translation you would like to delete.
From the ••• menu, select Delete.
In the Delete translation dialog, check if the selected language and version matches the translation you would like to delete
(optional) Select Delete Page Tree if you want to delete the actual Confluence page tree. Not selecting this option will delete only the translation metadata; the page tree will remain in the space but will no longer be considered part of the document.