> 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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://magecomp.gitbook.io/shopify/apps/sky-ai-theme-sections-blocks/theme-migrator.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.