We're delighted that you've chosen to get started with Scroll Versions.

This guide takes you on a tour of Scroll Versions' key functionality – how to activate Scroll Versions in a space, create new versions, and compare versions to review how new content will impact both of them. It's important to note that in using Scroll Versions, you are creating versions of entire spaces, not just pages.

Before you begin, make sure that you are in a space suitable for testing, as this guide involves creating mock pages and content.

1: Activate Scroll Versions 

Scroll Versions is activated in a space when you create the first version of a space. 

  1. Click Space Tools > Scroll Add-ons which will show you an overview of which features are enabled in this space and in this case, Scroll Versions.
  2. Under Scroll Versions > Versions click New Version 
  3. When creating a new version, you can define the version settings: 
    1. Version name: how you will identify this version, in this case 1.0. Version name may only contain letters, numbers and these special characters: . - _
    2. Description: description of the version
    3. Preceding Version: since this is our first version, this will have no preceding version
    4. Color: used for visualization or coordination, in this case Gray
    5. Release Date: anticipated release date for this version
  4. Click Create and your first version will now be activated. 
  5. Create an example page in version 1.0 and add some mock content.

2: Create a new version 

Now that versions has been activated, we want to create a second version to demonstrate the behavior of each version as content is edited or new pages are added. 

  1. Click New Version
  2. Enter the settings for the new version with the preceding version set to 1.0 which will mean that all content of 1.0 will be inherited by this new version. Add a new color, description, and name the version 2.0. 
  3. Click Create to create the new version.

3: Compare Versions

It's important to understand how content will behave in past and future versions. When you add a new page to a version, it then exists in the version you have specified and its subsequent versions, but none of the preceding versions. The same is true when editing a versioned page. Here is an example: 

  1. Always make sure you have the version you want to be working in selected in the version picker, in this case 2.0: 
  2. Create a new blank page in version 2.0. You will see that the working version is also visible in the editor on the top right. Name the page New 2.0 Feature, add some example content, and click Publish
  3. Switch to version 1.0 and you will notice that this page is not available in the preceding version.
  4. To see all changes, go to the Scroll Versions menu and select Compare Versions. Select the versions you want to compare, in this case 1.0 and 2.0. You can click 'Hide Unchanged' to only display pages with changes made.