Steps For Magento 1 to Magento 2 Migration

6 min readSep 22, 2021

Magento 1 to Mangento 2 Migration:

Magento 2 is an ecommerce platform built on open source technology, which is built by Roy Rubin and Yoav Kutner under Varien Inc. Magento was initial released on March 31, 2007. Magento 2 is the most used CMS (Content Management System) to create online stores around the world by its strong, scalable architecture. Magento 2 provides better results, improved site performance, and drive differentiated commerce experience.

Given all this, store owners must start planning of Magento 1 to Magento 2 Migration Services by approaching Best Magento 2 Development Company as soon as possible. If you are planning on moving over to Magento 2, continue reading this blog post, we going to give you a detailed summary of the Magento migration process.

Before you upgrade Magento 1 to Magento 2, here are some essential aspects to consider:

  • Review and examine what requires to be stored or removed from the new Magento 2 website.
  • Make assured you have a full backup of your Magento 1 store and the needed database, files, and folders.
  • Create a clone of your Magento 1 store. Do not use the live store for the Magento migration process..
  • Check if your current extensions, custom code, and themes are compatible with the Magento 2.
  • Remove outdated and useless data from the database including logs, recently viewed products, compared products, etc.
  • Install a recent copy of Magento 2 on the same hosting server where your Magento 1 store is located.
Bootsgrid Magento Migration Service

Why Is Magento 2 Better than Magento 1?

Magento supports all new tech stacks covers the latest PHP 7.4, Apache 2.4, NGINX 1.x, Elasticsearch 7.9.x. RabbitMQ 3.8.x, Varnish 6.x, etc. All mutually improve the speed and execution of the website. Conclusively, that supports in getting more orders and loads the frontend content faster than Magento 1.

With Magento 2.x, you can feel a meaningful result in SEO with and the rich fragments on the catalog pages. Also importantly, Magento 2 is more mobile-friendly as compared with Magento 1. The themes are more responsive, and the checkout process is also optimized, plus Magento 2 supports PWA that allows developing a mobile native application experience for the online store.

Magento 2 Migration Processes

According to the official documentation, Magento 2 migration consists of four different stages:

ü Theme Migration

ü Extension Migration

ü Customizations

ü Data Migration

Theme Migration

Magento 2 introduces new methodologies for delivering improved purchasing and store experience to the merchants and users on online. Developers can take advantage of the latest ways of creating impressive Magento 2 themes or change the current ones to make them compatible with the Magento 2 standards. You should keep in mind that you cannot directly migrate your Magento 1 theme to Magento 2. If No, then you can either create a custom theme in Magento 2 or buy and install a Magento 2 theme from Magento Marketplace.

Extension Migration

Extensions are necessary elements that provide new features and extend the functionalities of your Magento store. You have to check if Magento 1 extensions are compatible with Magento 2 version or not. If yes, then you can integrate the same extensions in Magento 2 by Magento Extension Installation. If No, then you have to add new extensions with similar functions, after moving to Magento 2. Magento extension migration process is to install the desired Magento 2 Extensions available on Magento Marketplace.


Magento 2 customization can be done by some of the magento service providers with Magento Custom Service. It should be noted here that due to structural differences in the two platforms, This Magento migration may need extra work to make sure that the custom code successfully integrates with the Magento 2 store.

Data Migration Using Data Migration Tool:

The finishing step is to migrate data from Magento 1.x to Magento 2. You can use Magento 2 Data Migration Tool for a smooth migration. With the help of this tool, you can migrate crucial data such as products, orders, categories, store settings & configurations, etc. to Magento 2.

A step-wise guide to data migration:

· Install Data Migration Tool via Composer

You can install the Data Migration tool into a new Magento 2 store using Composer. Remember, it’s not a Magento 2 extension, it’s a standalone test application that requires Magento 2 store to become operational. To install the Data Migration Tool, make sure that the version of Magento 2 store and Data Migration Tool match.

For example, if you are using Magento version 2.1.2, you must install the Data Migration Tool version 2.1.2. In general, If you are using the newest version of Magento 2 platform, you have to use the most current version of the Data Migration Tool as well.

Similarly, install Data Migration Tool v2.3.4 works for Magento 2.3.4. (LATEST MAGENTO VERSION)

Navigate to the root directory of your Magento 2 via SSH terminal and enter this command:

php bin/magento –version

Now that you know the version of your Magento 2 store installs the Data Migration Tool.

Keep in mind that you must update the location of the Data Migration Tool package in the composer.json file to make it work.

To do that, just run the following commands:

composer config repositories.magento composer

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

Here, <version> is your Data Migration Tool version. For example, for the Data Migration tool for Magento v2.1.2. You will have to replace <version> with 2.1.2

Composer require magento/data-migration-tool:2.1.2

Enter your authentication keys

Go to Magento Marketplace > Sign in > Click on My Access Keys

If you already have keys, the public key is your username and the private key is your password. Else, you can create a new key pair. Click on “Create a New Access Key Button.”

· Configure Data Migration Tool

After completing the installation, you will find the following directories to contain mapping and configuration files for the Data Migration Tool:

<Magento 2 root dir>/vendor/magento/data-migration-tool/etc/opensource-to-opensource

The above file will contain configuration and scripts for migrating from Magento 1 Open Source platform to Magento 2 Open Source platform.

<Magento 2 root dir>/vendor/magento/data-migration-tool/etc/opensource-to-commerce

The above file will contain configuration and scripts for migrating from Magento 1 Open Source platform to Magento 2 Commerce.

<Magento 2 root dir>/vendor/magento/data-migration-tool/etc/commerce-to-commerce

The above file will contain configuration and scripts for Magento migration from M1 Commerce to M2 Commerce.

Before migration of any data and settings to Magento 2, create a config.xml file in the relevant directory.


<database host=”localhost” name=”Magento1-DB-name” user=”DB-username” password=”DB-password”/>



<database host=”localhost” name=”Magento2-DB-name” user=”DB-username” password=”DB-password”/>





In the above code, <source> has the database information of Magento 1 and <destination> has the relevant database information of Magento 2. <crypt_key> is mandatory and needs to be filled prior run. It is the encryption key of Magento 1 store and can be found in the <Magento 1 root dir>/app/etc/local.xml file, within the <key> tag.

When finished, save the config.xml and you are done.

· Migrate Settings

Use the Data Migration Tool to migrate settings from Magento 1 to Magento 2.

This includes websites, stores, system configurations like tax settings, payment, shipping, etc.

You should migrate the setting first. To start with that, navigate to your Magento 2 root directory via SSH terminal and run this command:

php bin/magento migrate:settings — reset <path to your config.xml>

Where <path to your config.xml> is vendor/Magento/data-migration-tool/etc/ce-to-ee/<Magento 1.x version>/config.xml.

Upon successful moving from Magento 1 to Magento 2, a message will be displayed.

· Migrate Data

To migrate products, orders, wish lists, customers, categories, ratings, etc. follow this command:

php bin/magento migrate:data — reset <path to your config.xml>

Once the data migration is complete, you will receive a success message.


After the migration has been completed, run an analysis to assure that everything performs properly. I’ll hope this post helps you to migrate Magento website. Migrating from Magento 1 to Magento 2 is not easy, as it involves a lot of manual tasks.

Hope this documentation helped to drove this configuration successfully if you have any queries/doubts feel free to contact us at