4/14/2016 - #development #ecommerce #magento

*Cet article est disponible en français*

Migrating to Magento 2

Magento 2 was officially released 5 months ago and some merchants have already adopted it. Should you migrate your Magento 1.x website to Magento 2? How should you do it? Which tools should you use?

The Magento team describes how to proceed in their migration guide. But how do things stand?

We have summarized them for you and we give you the best advice to successfully perform your migration!

Why should you migrate to Magento 2?

Migrating to the new major version of a solution is never easy, and it can easily become disconcerting. Even though Magento 2 is a refined, optimized, and performing version, if your website is working well with Magento 1.x, wait and think about it before migrating. Magento 1 will still be loyal for long time and fully fulfill its function.

But if you need the latest technologies, functionalities, and to gain more performance, migrating to Magento 2 should be benefic.

If your choice is fully considered and if you are decided to do the migration, you should be strict and careful during the process. This is a full part of the project, which could stretch over many weeks, depending on your website. If you are not code-friendly, you should call a specialized agency.

How to successfully perform your Magento 2 migration?

Your migration isn't carried out in one task, but it depends to many elements. Begin to identify the different website layers you should migrate.

Here is a migration task list not to forget what to do :

  • Magento 2 installation

  • extensions and custom code migration

  • themes and templates migration

  • data migration

Magento 2 installation

First, you should install a fresh Magento 2, which will get all your data, themes, and extensions. Begin by installing it, then take charge of it. Even though Magento 2 is really similar to its previous version, its architecture is completely different. The database only doesn’t seem to have changed a lot. So, you can start the migration of your website to Magento 2!

Extensions migration

Before migrating your extensions, think about their relevance in Magento 2. Are they essential or are they considered as gadget? Remember that an extension has to make your work easier and convenient, not the opposite.

Then, is your extension available for Magento 2? If not, you should contact the extension editor or find a similar one. But if it is yours, you should upgrade your code so that it is compliant with Magento 2. For further information, please refer to the official Magento 2 development guide.

However, if your extension has its own data saved in your Magento database, you should migrate them. The data should be migrated at the end of the last process step.
Thus, even if the database changes are minor, you should pay attention to the table generator script  “InstallSchema”. To make it easier, a tool enables you to get the setup files from your tables. You should correct the script (foreign keys, table names...) to make it functional.

Once your extensions are on your Magento 2, you can migrate the rest of your website!

Themes and templates migration

Magento 2 uses a new approach including many tools for Magento 2 merchants and developers to create or customize themes and templates.

Nowadays, there is no migration tool to automate the change and import of Magento 1.x themes to Magento 2. As previously, it is essential to completely rewrite your theme and your different templates. But this migration may be the chance for you to create a new visual identity. Many themes are already available on the market.

Data migration

The data migration - the final step of a successful migration!

Importing your data from your Magento 1 is not the hardest migration task, but you should pay attention and be strict. Do not forget that your data are the most precious item in your store!

First, migrate your media files before your database data. This is about media files and contents downloaded by your customers or generated by your modules and extensions.

Copy the files and contents from the “media” folder in your Magento 1 root. Paste them in the “pub/media” folder in your new Magento 2 root.

Now you can take care of your database! There are many data migration tools. Two of them are fully developed and enable you to migrate your Magento configuration.

Let us start off with Magento team’s tool, “Data Migration Tool”. It is used in console and was designed for developers. But it allows you to custom your migration, which means that the data could be changed from some configurable rules.

Then, the tool developed by the UberTheme agency, “Magento 2 Migration Tool”. It was designed for any merchant, with or without programming skills. This tool offers a great user interface in your Magento 2 admin panel, which enables you to migrate your data step by step. This is the easiest tool to use. In addition to the tool post, UberTheme offers a demo in a short clip.

However, if you have an extension with its own tables, these tools do not allow you to migrate its data. You should import them by yourself.

Now, you have all the needed tool to succeed your Magento 2 migration !

Written by: Thomas Klein

Your comments

Feb 14, 2017
Very helpful post for Magento 2 migration.
We have also written a post on "Reasons to MIgrate". Please read:
An Nguyen
May 27, 2016
Hi there,

Thanks for having our Magento 2 Migration tool featured in your post.

Just want to share an update that we've just released a Premium version of migration tool. Here is the new clip on this Premium version: https://youtu.be/Jvr8d3OeB8M (Feature overview is available via: https://www.ubertheme.com/magento-news/magento-2-data-migration-pro-release/)

If possible, please help us add a note on this new version.

Many thanks,
An Nguyen
Head of Ubertheme team

Write your comment

for take-off?

Blackbird is a web agency specialized in the development of eCommerce websites. We are Magento Experts and we offer our services and advice for e-marketing, strategy, branding, deployment and methodology.

+339 50 66 21 38

Legal terms
Agency 30, Avenue du Rhin
67100 Strasbourg