---
title: "Step 1: Prepare for the Scaffolding migration"
canonical: "https://support.appfire.com/space/SCAFS/477607990/Step%201%3A%20Prepare%20for%20the%20Scaffolding%20migration"
format: markdown
---
# Prerequisites

Review the [Feature differences](https://appfire.atlassian.net/wiki/spaces/DEVSCAFC/pages/1534558568) document before starting the migration.

## Upgrade the Scaffolding app

> 📝 Update the Scaffolding app to at least version **8.25.0** through the UPM inside the Confluence administration console.
> 📝 
> 📝 If your pages contain **Repeating Data** macros, update the Scaffolding app to at least version **8.30.0** or **9.1.0**.

1. Select **Administration **( :cog-icon: )** **> **Manage apps**.
2. Search for **Scaffolding**.
3. Ensure the app is updated to the most recent version.

## Find the non-migratable Scaffolding macros

1. Ensure that the site search indexes are current**. **
2. Choose one of the options below to assess data compatibility between the Scaffolding Data Center and the Cloud:

### Option 2: Use SQL queries

Use the sample SQL queries below to help you gather all pages and templates that contain unsupported Scaffolding macros.

> 📝 This example uses PostgreSQL query syntax. You must adjust usage according to your database syntax. Also, to avoid performance issues, limit the outcome to a smaller scope if needed (using limit can help).

## Prepare the Scaffolding data for migration

Check the main templates and pages that your users are using and remove the structures that are incompatible with cloud. For information about the unavailable migration scenarios, refer to the [Feature differences](https://appfire.atlassian.net/wiki/spaces/DEVSCAFC/pages/1534558568) document.

## Create a staging instance and perform a test migration on sample data

> ✅ This is a recommended best practice step.

#### Test migration with a staging instance

<details>
<summary>Best practices to do a test migration with a staging instance</summary>

1. Create a [Staging environment](https://confluence.atlassian.com/doc/create-a-staging-environment-for-upgrading-confluence-866094180.html) licensed by a [developer license](https://confluence.atlassian.com/confkb/how-to-get-a-confluence-developer-license-152044449.html).
2. Create a snapshot of the current Confluence Data Center instance and clone it for the staging instance.
</details>

#### Test data by creating a sample space

<details>
<summary>Best practices to create test data by creating a sample space</summary>

1. Identify a space that contains:
  1. Space templates that are widely used in your organization and use Scaffolding macros.
  2. Pages with Live Template macros that are using the space templates.
2. Clone the contents of that space to a new space.
3. Prepare a migration window as highlighted below.
4. Go through the Test migration as highlighted in [https://appfire.atlassian.net/wiki/spaces/SCAFC/pages/edit-v2/1356071387#Find-all-the-Scaffolding-macros](https://appfire.atlassian.net/wiki/spaces/SCAFC/pages/edit-v2/1356071387#Find-all-the-Scaffolding-macros) and [https://appfire.atlassian.net/wiki/spaces/SCAFC/pages/edit-v2/1356071387#Prepare-the-Scaffolding-data-in-server](https://appfire.atlassian.net/wiki/spaces/SCAFC/pages/edit-v2/1356071387#Prepare-the-Scaffolding-data-in-server).
</details>

## Schedule the migration window

To estimate the time you will need for the migration steps, we recommend reviewing all of the steps before executing.

Depending on the size of the data and the complexity of the existing template configuration, it might take a few hours to complete these steps.

> ✅ It’s a best practice to schedule a maintenance window to perform the migration in your organization.

## Next Steps

Proceed to with [Cloud Migration](https://appfire.atlassian.net/wiki/spaces/DEVSCAFC/pages/1534297749).

## Questions?

Contact us via our [support portal](https://appfire.atlassian.net/servicedesk/customer/portal/11).