Skip to main content

How to upgrade from uSkinned Site Builder for Umbraco 9 to Umbraco 10

Step 1

Create a new Umbraco 10 project and install uSkinned Site Builder for Umbraco 10.

Follow our guide here if you are unsure how to do this.

Step 2

Install uSync against your new Umbraco 10 website.

dotnet add package uSync 

Step 3

Go to your Umbraco 10 website directory and delete the contents of:

~/wwwroot/media/

Go to your Umbraco 9 website and copy the contents of:

~/wwwroot/media

Paste your copied media into your Umbraco 10 website directory at location:

~/wwwroot/media/

Step 4

Locate the following file within your Umbraco 10 website directory:

~/appsettings.Development.json

Update the connection string to point to your Umbraco 9 database.

Set UpgradeUnatended to true.

Set RunSchemaAndContentMigrations to false.

{
  "$schema": "https://json.schemastore.org/appsettings.json",

  "ConnectionStrings": {
    "umbracoDbDSN": "Server=.;Database=DocsSite;Integrated Security=true"
  },
  "Umbraco": {
    "CMS": {
      "Unattended": {
        "UpgradeUnattended": true
      },
"PackageMigration": {
"RunSchemaAndContentMigrations": false
} } } }

Step 5

Go to your Umbraco 10 website directory and copy the contents of:

~/usn/updates/3.x

Paste the contents of the folder above at the route level of your website.

Run your website and login to the Umbraco CMS. Dont worry if you see an error when browsing the frontend of your website at his stage.

Go to the Settings (Section) > uSync (node) > Import Settings

This will update Document Type and Data Type changes

Go to the Settings (Section) > uSync (node) > Import Content

This will update Dictionary item changes

When the settings import is complete your website will be upgraded to Umbraco 10.

Step 6

If you have made any changes to your website design make sure you re-save your Design node to generate the stylesheet for your website.

#h5yr