Skip to main content
Skip table of contents

Migration Path

Scroll Viewport for Confluence Cloud only supports the Help Center theme – which means the WebHelp theme or custom themes can't be migrated.

Prerequisites

  • Viewport site is using the Help Center theme
  • You have installed Scroll Viewport for Confluence Cloud
  • You have permission to export the space
  • You have permission to edit the Help Center theme
  • You have permission to import the space into the Cloud instance

Things to Keep in Mind

  • Scroll Viewport for Confluence Cloud sites are publicly available once published.
  • Urls from your existing Viewport site are likely to break since the page ID of your Confluence pages will change. Learn how to keep Urls stable.

Migration Steps

These steps will explain how you can migrate your Viewport site which has the Help Center theme applied into a Confluence Cloud instance.

Step-1: Move content to Confluence Cloud

Step-2: Create a new Viewport site

  1. In the top navigation click on "Apps".
  2. Choose "Scroll Viewport" from the dropdown.
  3. Click on "Create new site".
  4. Enter a name and Url for your site (can be changed later).
  5. Click on "Save".

Step-3: Add your imported Space as a content source

After creating the site you will see an onboarding flow for Scroll Viewport for Confluence Cloud.

  1. Click on "Add content source".
  2. In the dialog search for your imported space and select it.
  3. Click on "next".
  4. Enter a path prefix.
    Preferably the same prefix which has been set for the space on Scroll Viewport for Confluence Server.

Step-4: Migrate the theme

To migrate the theme the best possible and easiest way you should follow these steps:

On your Confluence Server Instance

  1. Navigate to your Viewport settings of the exported space.
  2. Open the theme editor of your applied Help Center theme.
  3. Download all attached images you use within the theme.

On your Confluence Cloud Instance

  1. Navigate to space homepage of the imported space.
  2. Open the page attachments.
  3. Upload all images you downloaded from the server theme.
  4. Open your Viewport site by clicking "Apps" and selecting "Scroll Viewport".
  5. Navigate to Single Site Overview.
  6. Open theme editor (should be the shown on-boarding step).

Step-5: Apply theme settings

Most theme settings in the theme editor on Confluence Cloud are in the same order and work the same as they are on Confluence Server.

On your Confluence Server Instance

  1. Navigate to your Viewport settings of the exported space.
  2. Open the theme editor of your applied Help Center theme.
  3. Open theme-settings.properties file.

On your Confluence Cloud Instance

  1. Open your Viewport site by clicking "Apps" and selecting "Scroll Viewport".
  2. Navigate to Single Site Overview.
  3. Open theme editor.
  4. Compare the settings of your theme-settings.properties file and the settings in the theme editor.
  5. Adjust the settings accordingly.
  6. Once done, save the theme and close the editor.

Step-6: Generate a preview

A main difference between Scroll Viewport Server and Scroll Viewport Cloud is that on Cloud you have control over when you want to make your changes publicly available.

  1. Click on "generate preview" (depending on the size of the space, this might take a while but doesn't require your attention).
  2. Once the preview is generated you can either:
    1. Take a look at the Preview Report and preview your Viewport site.
    2. Or go live immediately.

Once your Viewport site is live it is accessible publicly through the given URL defined in Step-2.
You can take your site offline again if you need to.

Learn more about:

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.