Migrate to Capable Sites

View as Markdown
Open in ChatGPT Open in Claude

#Preparation

#1. Create a new site in Capable Sites

Set up your new site in Capable Sites by:

  • Naming the site

  • Configuring access control

  • Setting the scope to match the existing site

  • Customizing the theme

Create a new Capable Site

#2. Ensure space paths match your existing site

Use the ‘URL slug’ input to match space paths to your existing site.

Add spaces to a Capable Site

#3. Copy existing redirections

Tools like Scroll Viewport/Sites and Refined allow custom redirections that retain existing behaviour by redirecting users to new pages.

Copy and paste existing redirections into Capable Sites.

Set up Redirections in Capable Sites

#4. Download the sitemap for the existing site

After addressing Space paths in step 2, ensure Page paths match by downlain existing behaviour by redirecting people navigating to these paths to the new pages.

You can copy the existing redirections and paste them into Capable Sites.

Set up Redirections in Capable Sites

#5. Download the sitemap for the existing site

We addressed Space paths in step 2, but we must also ensure that Page paths also match. For this, we will download the sitemap for the existing site and correlate this with the sitemap from the staging site in Capable Sites. e.g. https://help.gocapable.com/sitemap.xml

<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
  <url>
    <loc>https://help.gocapable.com/capable/</loc>
  </url>
  <url>
    <loc>https://help.gocapable.com/capable/manage-slack-connections</loc>
  </url>
  ...
</urlset>

You may have to download the sub-sitemaps for each space in scope.

You can use AI to do this quickly and in parallel.

#6. Generate a new staging version in Capable Sites for the site

Generate the staging version for your site in Capable Sites

Download its sitemap.xml file from the same path as above.

Capable Sites Configuration

#7. Add redirections for any incorrect URLs

Ensure that the sitemap from your existing site matches that of the new site.

If it does not, you can either change the ‘Page slug’ on a per-page basis, or add a redirection rule to correct the routing.

#Go Live

#1. Disconnect your existing site from the Custom Domain

In order to connect your domain to Capable Sites, you must first disconnect your existing site solution in order to free up the certificate to be generated to allow secure connections via our infrastructure.

#2. Connect Capable Site to the Custom Domain

Follow the instructions in the app to connect the custom domain.

You will need to add DNS records for (a) the certificate and (b) the subdomain routing.

Capable Sites Custom Domain

#3. You’re live!

Your site is now live and you should perform any post-migration validation.