> For the complete documentation index, see [llms.txt](https://magecomp.gitbook.io/shopify/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://magecomp.gitbook.io/shopify/apps/sky-ai-theme-sections-blocks/theme-migrator.md).

# Theme Migrator

The **Theme Migrator** helps you transfer only the sections created through our app from one Shopify theme to another. It ensures a safe migration process without affecting your live store setup.

### Recommended Safe Migration Steps

Before starting migration, we strongly recommend:

* **Duplicate your target theme first**
  * This creates a backup copy of your live theme
  * If anything goes wrong, you can easily restore the original version
* **Do not migrate directly to a published theme**
  * We don’t support direct changes to live/published themes for safety reasons
* **Theme version update note**

  * When a Shopify theme is updated, Shopify automatically creates a duplicate theme for safety

  ### How Theme Migrator Works

  The migrator transfers only the sections that were **created using our app**.

  #### - Included in Migration:

  * Sections created/imported via the app
  * App-generated blocks and layouts
  * Saved configurations of those sections

  #### - Not Included in Migration:

  * Custom-coded Shopify sections (manually created in theme files)
  * Third-party app sections
  * Theme files or general theme settings
  * Any modifications outside our app

### **Migration Process**

#### Step 1: Select Source Theme

Choose the theme where your app sections currently exist.

<figure><img src="/files/xvdyBa2ZuFAAQPTIv0CF" alt=""><figcaption></figcaption></figure>

#### Step 2: Select Target Theme

Choose the theme where you want to transfer sections.

<figure><img src="/files/uJQDNG5nyJg94gc5WN5P" alt=""><figcaption></figcaption></figure>

#### Step 3: Run Migration

The system will:

* Detect all app-created sections from the source theme
* Copy them into the selected target theme

You have two options:

#### 1. Select All Sections

* Use the **“Select All”** checkbox
* This will migrate **all app-created sections at once**
* Best for full theme migration

#### 2. Select Specific Sections

* Manually select only the required sections
* Example:
  * SKY Glow Testimonial
  * SKY Product Ingredients
  * SKY Text Block
* Only selected sections will be migrated

This gives full control over what gets transferred.

<figure><img src="/files/oVVsMkSHtbGGi9mBAVe7" alt=""><figcaption></figcaption></figure>

#### Step 4: Run Migration

Click **Migrate**, and the system will:

* Detect selected app-created sections
* Transfer them to the target theme
* You can also see the previous migration details

<figure><img src="/files/URiN5SPXsIGNsMXnVLpZ" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/pnHyqORDjdIcyufbuUjM" alt=""><figcaption></figcaption></figure>

### Example

#### Source Theme: “Dawn”

Contains:

* SKY Glow Testimonial
* SKY Product Ingredients
* SKY Text Block
* SKY Blog

#### Target Theme: “Spotlight”

If the user selects only:

* SKY Glow Testimonial
* SKY Blog

Only these two sections will be migrated, and other sections will not be transferred.

### What is NOT Migrated

* Custom-coded Shopify sections (manual theme code)
* Third-party app sections
* Theme settings or layouts outside the app
* Any non-app sections

### Purpose of Theme Migrator

* Safely move app sections between themes
* Avoid rebuilding sections manually
* Maintain control over migration scope
* Prevent unnecessary or unwanted section transfers
* Ensure safe workflow without affecting the live store