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: Create a Clean template

Step 2: 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.

Migration tip:

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

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:

• 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:

Then follow exactly the steps above to create templates for Pages and Articles.

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.

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