Migration

This tool enables you to migrate all templates and app blocks created by the Easy Content Builder app from an existing theme to a new one.

Requirements

• The destination theme must be an OS 2.0 theme that supports template files of product, article, and page in JSON format.
• You can not migrate data to the Demo (Free Trial) theme until you buy it.

How does migration work?

• The migration utility will create new templates in the Destination theme based on the default JSON template files of products (product.json), pages (page.json), and articles (article.json).
• And copy App sections from the templates of the Source theme to the bottom of the corresponding templates in the Destination theme.

Migration Steps:

Step 1: Back up the Destination theme

Before migration, it's a good idea to make a backup copy of the Destination theme - the new OS 2.0 theme that you want to migrate over - so that you can discard your changes and start again if you need to.

• From your Shopify admin, go to Online Store > Themes.
• For the theme that you want to duplicate, click the ... button to open the actions menu, and then click Duplicate.

The duplicate theme will be named Copy Of + the name of the theme that you duplicated and appears on the Themes page.

Step 2 (Optional): Create a Clean template

With the current migration workflow, after migration, all migrated content blocks will append at the bottom of the Destination theme like the screenshot below:

<image>

If you want the Destination theme only shows the migrated content blocks (in the migrated templates) without sections from the default templates - product.json/page.json/article.json, you can follow these steps:

Create a Clean template for products:

• From the Shopify Theme editor, tab Products > click Create template in the dropdown menu.
• Then enter clean to the Name field & set the Default page to Based on:

<image>

Create a Clean template for Pages:

• From the Shopify Theme editor, tab Products > click Create template in the dropdown menu.
• Then enter clean to the Name field & set the Default page to Based on Create a Clean template for Blog Posts:
• From the Shopify Theme editor, tab Products > click Create template in the dropdown menu.
• Then enter clean to the Name field & set the Default page to Based on:

Note: Steps above are aimed at creating a template with .clean suffix (product.clean.json, page.clean.json, article.clean.json) so that these page types can remove those default sections before performing the migration.

Step 3: Migrate the templates and content blocks created by Easy Content Builder

• From the Easy Content Build dashboard, click the Migration tool.
• Identify the Source theme - the original theme on which you created the templates and content blocks using the Easy Content Builder app.
• Identify the Destination theme - the new OS 2.0 theme that you want to migrate over.
• Click Submit. Then, you will be prompted a confirmation message, click OK to proceed with the migration.

Once done, you can perform the migration as noted in section 5.3. Migration Steps.