Template Migration

From Posstack.com Documentations
Revision as of 09:19, 31 May 2024 by An (talk | contribs) (→‎Next Step)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

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.


  • 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. Ecb template migration.jpg

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, all migrated content blocks will append at the bottom of the Destination theme after migration.

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 need to create three Clean templates in the Destination theme - each for a page type: Product, Page, Blog Post.

Please refer to the section Create Clean Template for more details on how to create a Clean template.

Default vs clean templates migration.jpg

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.

Ecb template migration form.png

If a template already exists in the destination theme (which means you successfully migrated the template before), the migration tool will notify 'no new templates created'.

If there are any issues during the migration, the migration tool will notify you of details of the error. Then you can resolve and migrate again to transfer those pending items from the old theme to the new theme.

Migration, Before and After

Below is an example of the Smartphone A55 product in the Dawn theme (the Source theme) before migration and that same product in the Craft theme (the Destination theme) after migration.

As can be seen, all content blocks created by the Easy Content Builder have been migrated to the Destination theme 'Craft'. They inherit the style of the current Craft theme by default.

Ecb template migration result.jpg

You can check out the Easy Content Builder demo to see sample content blocks in different themes: Dawn, Craft, Crave, Refresh, and Sense.

Next Step

Now that you have all migrated content blocks in the Destination theme, you can add, remove, or edit those content blocks to your need. (Please refer to the Add Sections for more details)