Looking to migrate from Magento 1 to Magento 2? If you are planning this migration because Magento 1 support going to end this November 18th, 2018, then here’s what you need to know first:

A lot of Magento evangelists, leading bloggers, and experts expects the end of Magento 1 to be near. Although it was announced several times, there was no citable statement about it.

However, Magento Inc. announced postponing of the end of support for Magento 1. Also, they promised to announce the end of Magento 1 support at least 18 months prior.

Migrate From Magento 1 to Magento 2

But you should still move to Magento 2. Here’s why:

  1. Continuing support for Magento 1 doesn’t mean there will be innovation in M1. Therefore, for better support solutions, you must migrate to Magento 2.
  2. Magento 2 is a world-class commerce system. It provides better visibility into business results, improved site performance, and drive differentiated omnichannel commerce experience.
  3. Magento 2 is the future. Every person will benefit from moving to Magento 2.

Considering the criticality, it is important to migrate to Magento 2. Most of the e-commerce shops and development agencies have already started with the migration.

Must Read: Magento 2.3 Out Now! Explore new Features and Functions

Considerations before Migration

Before you migrate from Magento 1 to Magento 2, here are some important aspects to consider:

Step 1: Know your website

Review and analyze what needs to be kept or removed from the newly installed site on Magento 2. Also, ensure if the current site theme, extensions, and code are compatible with the new version or not.

Step 2: Make backups

Before you migrate to M2, make sure you have a full backup of your Magento 1 store and the required database, files, and folders.

Step 3: Clone Magento 1 store

Avoid using the live store for the migration process. Migrate the data from the cloned database of the M1 store.

Step 4: Ensure compatibility

Check if your current extensions, custom code, and themes are compatible with the Magento 2.

Step 5: Boost performance of Magento 2

After you have installed Magento 2, set the option “<direct_document_copy>1</direct_document_copy>” in your config.xml.

Plan your Magento 1 to Magento 2 Migration

You may Like: Speed up Magento 2: 9 Proven Practices for Every Store Owner

4 Stages to Migrate Magento 1 to Magento 2

  1. Theme Migration
  2. Extension Migration
  3. Customizations Migration
  4. Data Migration

#1. Theme Migration

There are new technologies and methodologies for delivering enhanced store and shopping experience to owners and users.

However, you can’t directly migrate your Magento 1 theme to Magento 2.

Therefore, you have to create a new theme for Magento 2 and make it responsive to the best user experience.

You can either create a custom theme in Magento 2 or just buy and install a Magento 2 theme from Magento Marketplace.

#2. Extension Migration

Extensions provide new features and extend the functionalities of your Magento store.

Now, you need to install the Magento 2 extension of your choice.

Note: Magento 1 extensions will not work on Magento 2. There are severe compatibility issues while integrating the extensions.

#3. Customization

Mostly, the custom code used by Magento 1 store is compatible with Magento 2.

There’s a Code Migration Toolkit to help you with the process.

Since there is a structural difference in the two platforms, migration may require additional work to ensure the custom code works successfully with the Magento 2 store.

#4. Data Migration

The last thing you need to do is move your Magento 1 data as well as settings to Magento 2. You can use Magento 2 Data Migration Tool for easy migration.

With the help of this tool, you can migrate critical data (products, orders, categories, store settings & configurations, etc.) to Magento 2.

Migrate data to Magento 2

Here’s a step-wise guide to data migration:

4.1. Install Data Migration Tool via Composer

1. Before installing this tool, make sure the version of both – Data Migration tool and Magento 2 are exactly the same. For example, if you are using Magento v2.1.1, you must install the Data Migration Tool v2.1.1.

Don’t know your Magento version?

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

php bin/magento --version

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

Note: Update the location of the Data Migration Tool package in the composer.json file in the Magento 2 root directory. To do this, run this command:

composer config repositories.magento composer https://repo.magento.com
Composer require magento/data-migration-tool:<version>

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

Composer require magento/data-migration-tool:2.1.1

3. 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”.

You May Like: A Complete Guide: How to Install Magento 2 & Verify Installation?

4.2. 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/ce-to-ee

This contains configuration and scripts for migrating from Magento 1 Community Edition to Magento 2 Enterprise Edition.

For Magento 1 Enterprise Edition to Magento 2 Enterprise Edition, use this command:

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

Note: Before migrating any data and settings, 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” />


<source> : has Magento 1’s database information
<destination> : has relevant information of Magento 2
<crypt_key> : encryption key of Magento 1 which can be found in in <key> tag for <Magento 1 rootdir>/app/etc/local.xml file.

Lastly, save config.xml file.

4.3. 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 migration, a message will be displayed.

Must Read: Magento 1 vs Magento 2: Top 6 Differences You Must Know

4.4. Migrate Data

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

php bin/magento migration:data --reset <path to your config.xml>

If in case, there’s an error during the migration, refer Magento’s Troubleshooting page.

Wrapping it up..

After the migration has been done, run a test to ensure proper functioning of Magento 2.

Migrating from Magento 1 to Magento 2 is not easy, as it involves a lot of manual tasks.

For hassle-free and safe migration, you can hire experts to get your job done.

Services we offer:

  1. Managed Magento Hosting for Businesses
  2. Managed WordPress Hosting for Business-Agency
  3. AWS Management
  4. DigitalOcean Managed
  5. Managed Cloud Server India
  6. Dedicated Server India

Enquire now and join 1000+ businesses who have blitzscaled their websites by choosing ServerGuy as their hosting partner.


Grow with confidence backed by our fully Managed Hosting. Join 1000s of Brands & Agencies across the globe who trust us.