Breadcrumbs

Migration Path

Scroll Sites for Confluence Cloud does not support the WebHelp theme.

Prerequisites

  • Your Viewport is using the Help Center theme. If you are using a custom theme, please reach out to help@k15t.com for assistance with a custom migration path.

  • You have installed Scroll Sites 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

  • URLs from your existing Viewport 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 which has the Help Center theme applied to a Scroll site on a Confluence Cloud instance. If you are using a custom theme, please reach out to help@k15t.com for assistance with a custom migration path.

Step-1: Move content to Confluence Cloud

Step-2: Create a new Scroll site

  1. In the Confluence sidebar navigation click on "Apps".

  2. Choose "Scroll Sites" from the dropdown.

  3. Click on "Create new site".

  4. Go through the site creation wizard following the steps on Create a Site .

  5. In the “Set up your site” step, make sure to create an ‘unpublished site’.

  6. In the “Add content” step, make sure you add your imported space as the content for your site.

  7. Click “Create”.

Step-3: 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. Download all attached images you use within the theme.

  4. Open the theme editor of your applied Help Center theme.

  5. Open theme-settings.properties file.

On your Confluence Cloud Instance

  1. Open Scroll Sites by clicking "Apps" and selecting "Scroll Sites".

  2. From the My Sites screen, find the card for the site you want to customize.

  3. Click Site Settings > Look and feel > Customize theme. The theme configurator will open.

  4. Compare the settings of your theme-settings.properties file and the settings in the theme configurator.

  5. Adjust the settings accordingly.

  6. Once done, save the theme and close the configurator.

(Optional) Step-4: Set up your custom domain and redirects

On your Confluence Server Instance

  1. In the Viewport spaces, find all redirect macros and note down the redirects

  2. Go to your Confluence's General configuration. In the Scroll Sites section, click URL Redirects. Note down all redirects here as well.

You should also take care to remove any existing CNAME records from your DNS configuration before you proceed.

On your Confluence Cloud Instance

  1. Follow all the steps on  Connect a custom domain

  2. Follow the steps to set up your  literal redirects  or  regex redirects

Step-6: Bring your site live

  1. In Scroll Sites on Cloud, for the site you created click on "Go live" from the sidebar.
    Depending on the size of the space, this might take a while but doesn't require your attention.

Once your Scroll site is live it is accessible publicly through the given URL defined in Step-2.

Learn more about: