Display Translated Content
Show translations of your content on your site and allow users to navigate between the content in different languages.
To use this feature of Scroll Sites you will need to install Scroll Documents first. Trial the app for free for 30 days.
Scroll Sites lets you add a Confluence space or a Scroll Document as a content source. The advantage of adding a Scroll Document as a content source is that you can configure and show different translations of your content to create a multilingual site.
When you select to publish two or more languages of a document, Scroll Sites will add a language picker to your site. This picker allows your site visitors to choose and navigate between different translations of your site's content.
Before You Begin
Prepare your multilingual site by indicating under Site Settings what the default language of your site’s content is. Learn how to Set a Default Language .
To publish content in selected or multiple languages to a Scroll site, your content needs to exist as a Scroll Document. This Scroll Document can then be added as a content source to any Scroll site.
Already have a site with a Confluence space as a content source and want to replace it with a Scroll Document? Learn how to convert any space into a Scroll Document.
To get started, make sure to:
Install Scroll Documents for Confluence Cloud. You can start with a free 30 day trial.
Optional: If you want to unlock the full potential of the language functionality in Scroll Documents, you’ll also need to install the extension app Translations for Scroll Documents. You can start with a free 30 day trial.
Create your first Scroll Document. Either from scratch or out of an existing space or page tree.
Start to Manage Translations.
Select an existing Scroll site or create a new site.
Set a default language for your site.
Now you are ready to start adding your Scroll Document(s) as a content source.
Selecting Which Languages to Publish (Per Scroll Document)
To be able to select which languages of your Scroll Document should be published in your Scroll site, first add your Scroll Document as a content source to your site.
Once the Scroll Document is added, it will appear as a card in your Content list in the Site settings screen.
By default, all languages available in your document will be included for publishing in the site. That means, a translation for each of these languages will be published for all those versions that are selected in the site.
You can’t unpublish a language for a specific version but only for all versions in your site.
To edit the default language selection for a Scroll Document content source:
From the My Sites screen, click the card that has your site’s name.
From the left sidebar, click Site Settings > Content. In the Site settings screen, you will find a card per content source that is added to your site.
From the card of the Scroll Document content source you want to edit the language selection for, click the blue indication that reads x/x Languages. A table of all existing languages for this document will expand.
From the language table, use the toggles in the last column to turn the languages on or off for your site. This means:
If a language is turned off: Any available translation in that language for all the versions of this document that are selected in your site will be ignored and not published in your Scroll site.
If a language is turned on: Any available translation in that language for all the versions of this document that are selected in your site will be included and published in your site.
⚠️ The language you have set as the site’s default language will always be included and can’t be turned off for the site.
From the Site settings screen, click Publish changes or Save changes in the top right.
Your change will now automatically trigger a new site update (for sites set to live updates) or be applied with your next site update (for sites set to manual updates).
Navigating a Site with Multiple Languages
With your next site update, Scroll Sites will add a language picker to all pages of the content source for which you have turned on multiple languages. Use this picker to navigate between all the translations available in the site.
Switching languages will always land you on the same version and same article you started switching from (if such a matching page exists) or on the content source’s root page (if a matching page doesn’t exist).
The selected language is used to assign the right language attribute to the pages of your Scroll site (e.g. <html lang=“en”>). This metadata also helps screen readers and search engines return language specific results.
If the selected language is one of our officially supported languages, the help center theme will automatically adjust to that language. This means, error messages and standard texts in places like the footer or search page will always show in the right language.
To ensure smooth navigation throughout the site, your site’s URLs will include a language code: /language/content-source/version/page.