Magento Data Migration Tool

With the constant updates of Magento and its latest features, many eCommerce merchants faced the need to migrate their stores from Magento 1 to more advanced versions of Magento 2. In this case, there are several ways to migrate to the latest Magento version with Adobe’s Data Migration Tool or with automated applications. Nevertheless, we will discuss Magento Data Migration Tool and how to install and use it.

What is Magento Data Migration Tool?

The Magento Data Migration Tool is an Adobe application that allows transferring product information, customers, categories, and order data from Magento 1 to the latest version of Magento 2. Notably, the developers of Magento encourage the merchants to migrate to the upgraded platform not only due to the more advanced features that are available there but also because it is a more secure and scalable platform that can be beneficial for every eCommerce store.

The main principle of the Data Migration Tool is the notion that it is used to connect the databases of Magento1 and Magento2. Namely, the tool operates as a command-line interface that verifies the structures between the platforms and can perform the transferring of data and test runs. The tool has three modes for migration which include migration: 

  • Settings;
  • Data;
  • Data updates which were on previous versions of Magento (this mode is called Delta)

Thus, the main advantage of the Data Migration Tool is that it is consistent in the identification of data from Magento 1, and can effectively transfer it to Magento 2.

How to use Magento Data Migration Tool?

Before actually performing the migration, a merchant needs to assess whether Magento 2 supports the extensions that will be transferred. After that, one must ensure that Magento 2 and Data Migration Tool are the same versions.


Subsequently, as the official Adobe instruction suggests, one can install Data Migration Tool from the Magento root installation directory ( with the commands:

composer config repositories.magento composer
composer require magento/data-migration-tool:<version>

With <version> is your Magento 2 version.

However, you can also install it from Github with the following commands:

composer config git
composer require magento/data-migration-tool:<version>

With <version> is your Magento 2 version.

How to use Data Migration Tool

Firstly, one has to establish the connection between the Magento 1 and Magento 2 websites. 

The basic process data, settings, and changes migration involves the following command syntax:

bin/magento migrate:<mode> [-r|–reset] [-a|–auto] {<path to config.xml>}

With <mode> can be settings, data, or delta


  • [-r|–reset] means starting migration again and can be used for the testing.
  • [-a|–auto] assures that migration proceeds even in case when an error is detected.
  • {<path to config.xml>} is the absolute file system path to config.xml; this argument is required.

Nevertheless, some of the parts of Magento sites should be migrated manually. For example, media, website designs, admin accounts, and Access Control Lists (ACLs). 

For the media migration, use this command: 

<your Magento 1 install dir>/media to <your Magento 2 install dir>/pub/media

Meanwhile, you need to relocate the design templates manually and re-create all Access Control Lists (ACLs), including credentials for APIs and admin pages and accesses.


Lastly, one may admit that the migration to a more advanced version of Magento is a very effective decision due to the improved security and functionality of Magento 2. As we mentioned, the migration process with Magento Data Migration Tool is complicated for merchants without technical expertise. However, for experienced eCommerce developers, this process can be executed smoothly, especially with the official documentation that is very well-written and answers all the questions regarding the Data Migration Tool. Therefore, the most effective way to perform the migration for a merchant without technical knowledge is to hire a professional eCommerce developer who can execute all the steps flawlessly and help you with the transition to Magento 2 store.

Related Articles

Notify of
Inline Feedbacks
View all comments