Show versions of your content on your site and allow users to navigate between the versions.
To use this feature of Scroll Sites you will need to install Scroll Content Manager 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 version of your content on your site.
When you select two or more versions of a document, Scroll Sites will add a version picker to your site. This picker allows your site visitors to choose and navigate between different versions of your site's content.
Selecting Which Versions to Publish (Per Scroll Document)
To get started, make sure you have created your first Scroll Document and created a 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 be able to select which versions 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 your versions except for your working version are selected for the site. If you only have a working version, then this is the version that is selected by default.
To edit the default version 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 version selection for, click the arrow icon in the far right of the card or the blue x/x Versions indication. A table of all existing versions for this document will expand.
-
From the version table, use the check-boxes in the first column to select or deselect the versions that should be published in your site.
When adding multiple versions to your site, we recommend you do not include the working version.
Always use the working version to prepare changes and save a version once complete. Add those snapshot versions instead of your working version to your Scroll site.
-
Optionally: For each version you can click the pen icon in the far right of the table to specify the version name and URL path that should be displayed in the site for this version
Have only one version selected for your site? You can optionally omit the version path from the site URL by leaving the URL path field empty. This can help you create cleaner and more user-friendly URLs for your site visitors. → Learn more
-
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 Between Different Versions on a Site
With your next site update, Scroll Sites will add a version picker to the header of all content source pages for which you have selected multiple versions. Use this picker to navigate between all the document versions you selected for your site.
Switching versions will always land you on the corresponding page in the other version, as long as a related page exists.
Remove the Version Path From the URL (Single Version Only)
When only one version of a Scroll Document is selected for your site, you can remove the version path from the URL completely. This is useful if you only publish a single version of your content and don’t want a version name to appear in your site URLs.
Changing or removing a version URL path can break existing links to your site. Only remove the path if you're sure you won't add more versions or variants later
To remove the version path:
-
From the My Sites screen, click the card that has your site’s name.
-
From the left sidebar, click Site Settings → Content.
-
From the card of the Scroll Document content source, click the arrow icon in the far right of the card or the blue x/x Versions indication. The version table will expand.
-
Make sure only one version is selected.
-
For that version, click the pen icon in the far right and clear the URL path field.
-
From the Site settings screen, click Publish changes or Save changes in the top right.
Leaving the URL path empty will remove the version URL path from the site URL.
With your next site update, your URLs will no longer include the version segment. For example, a URL that used to look like this:
https://your-company.scroll.site/your-document/v1/my-article
will now look like this:
https://your-company.scroll.site/your-document/my-article
What happens when you add a second version
As soon as you add a second version to the same content source, every version must have a unique, non-empty URL path again, so that visitors always land on the correct version.
If a single version with an empty URL path is already saved when you add a second version, the content source will go into an error state and you won’t be able to save changes until you provide a URL path for each version.