Get a free Consultation

    Search for:

    Last Updated | January 18, 2022

    What is Magento Data Migration Tool?

    The Magento data migration tool is a CLI that is short for command line interface. The tool is used primarily for transferring data from Magento 1 to Magento 2. The tool migrates data between Magento 1 and Magento 2 by ensuring consistency in transferring database structures (records and fields), creating catalogs, tracking data transfer progress, and running data verification tests. The Magento data migration tool has four major components: data, customized code and extensions, themes, and customizations.


    The Magento 2 data migration tool can help you safely migrate all your customers, products, order data, promotions, and store configurations to your Magento 2 store. The tool makes use of the safest and best practices to ensure that the process is error-free and quick. This tool is made use of even by professional Magento migration services as it makes the work easy and safe.

    Extensions and custom code:

    The tool has been developed with the best Magento developers who continue to work hard with the community to help Magento store owners. The tool also allows store owners to use your Magento 1 extensions in Magento 2. You can even install or purchase the most suitable versions of your favorite Magento store extensions.

    Themes and customizations:

    The new Magento 2 makes use of new technologies and programming approaches that give merchants an unmatched ability to develop innovative shopping experiences for their customers. The tool can also help to scale your store by scaling it to new levels. To reap the benefits of these technological advancements to their maximum potential, store owners will need to make changes to their themes and customizations. The Magento data migration tool helps in migrating Magento 2 themes, layouts, and customizations.

    Just like the Magento upgrade between 1. x versions to the newer 2. x versions, the level of effort and expertise required to migrate data from Magento 1 to Magento 2 stores majorly depends upon how you have developed your store and the level of customization. So it does require experience and professional Magento agency partners to help you out in this process. However, the tool is constantly under improvement to decrease migration efforts are and increase the effectiveness.

    How to Use Magento 2 Data Migration Tool?


    The tool can be used by almost anyone but it does require some technical skills.

    The Tool operates in three modes:

    Data:  This migrates all the main data in the database in bulk.

    Settings: This only migrates the configuration settings.

    Delta: This mode exchanges incremental upgrades for the data, included to the Magento 1 storefront and after that to the admin board after running past migration modes.

    Each mode consists of different steps that perform tasks that are defined in the modes. Each step initially checks for data integrity and the structural integrity between the Magento 1 and Magento 2 data repositories and only after verification advances to perform the transfer. The migration tool then checks the total volume of transferred data. You will have to install the Magento 2 data migration tool before advancing.

    Migrate your data:

    Rules for a successful migration.

    Stop all Magento 1 cron jobs before you start the migration.
    During the migration process make sure that you do not:

    1. Make changes to the Magento 1 administrator board with the exception of the order management.
    2. Make changes in the Magento 2 Admin and the storefront.
    3. Alter any code of the store.

    Run the Data Migration Tool.

    This section will explain how to run the Magento 2 Data Migration Tool to migrate data.

    First steps.

    1. Firstly, you must log in to the Magento store as an administrator, or switch to a user who has relevant permissions to write data to the Magento file server system.

    If you make use of the bash shell, you can use the following command to switch to the file system owner and enter the command simultaneously:

    $su <file system owner> -s /bin/bash -c <command>

    In case the file system does not allow logins, you can run the following command:

    $sudo -u <file system owner>  <command>
    • In order to successfully run Magento commands from any directory, add the following command to your system path.

    <magento_root>/bin .

    Shells have differing syntax, so look up your shell syntax to set the path. A sample for the bash shell for CentOS for path addition is:

    $export PATH=$PATH:/var/www/html/magento2/bin

    You can run different commands in the following semantics:

    1. cd <magento_root>/bin and  then run them as ./magento <command name>
    2. <magento_root>/bin/magento <command name>
    3. <magento_root> is a subdirectory of your web server docroot.

    Command syntax

    Below is one example of a command on the Magento data migration tool:

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


    •  The [-a|--auto] is an argument that is optional and that prevents the migration from stopping as it encounters any integrity errors.
    • The [-r|--reset] is also another optional argument that starts migration from the beginning. You can use this argument for the testing of the migration.
    • <mode> may be: settingsdata, or delta
    • The path system {<path to config.xml>} is the absolute file path to config.xml; this argument is a must.

    Migration order

    The Magento Data migration tool was built by the developers assuming the following sequence for data transfer:

    1. Settings
    2. Data
    3. Changes

    That’s why it is most preferred to maintain this order in order to migrate without any issues and quickly.

    Migrate settings


    1. Change the Magento 2 /bin directory or make sure it is added to your system path beforehand.
    2. Log in to the server with your Magento 2 instance as the file system owner.
    3. Ensure that your Magento 2 is deployed in the default mode because developer mode may cause validation errors.

    Run the settings migration command

    To start migrating settings, run:

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


    • {<path to config.xml>} is the file absolute path to the migration tool’s config.xml file. This argument is required.
    • [-r|--reset] is one optional argument that will start the migration from the beginning. This argument is best utilized in testing.
    • [-a|--auto] is one parameter that makes sure that once integrity checks are detected, the migration process is not stopped but keeps on working.

    After the settings are transferred successfully, the Migration completed message pops up.

    Configure custom migration rules.

    These migration rules may be ignored, renamed, or changed as per the system configurations when migrating the store settings. You can specify your customized rules in the settings.xml file.

    1. Log in to the server with your Magento 2 instance as, or switch to, the system file owner.
    2. Change to the following directory:
    cd <your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/<edition-to-edition>

    For instance, if Magento 2 is installed in the /var/www/html, you will find the settings.xml.dist in the relevant directories.

    • To create a settings.xml file from the provided sample, run:
    cp settings.xml.dist settings.xml
    • Make your changes in settings.xml.
    • To specify the new name of the settings file for mapping, change the <settings_map_file> tag in the path/to/config.xml file.

    Migrate data

    Before you start: routine preparation

    1. Log in to the Magento server as system owner of the store.
    2. Change to the Magento installation directory to the tool or make sure it is added to your system path.

    Run the data migration command

    To start migrating the data, run:

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


    • [-a|--auto] is one argument. This optional argument prevents the migration process from halting when it encounters any integrity check errors.
    • [-r|--reset] is another optional argument that ensures the migration starts from the beginning. This argument can be used for testing.
    • This argument is not optional and is mandatory.
    • {<path to config.xml>} is the system path for the file to config.xml.

    The Magento Data Migration Tool initiates triggers for the tables from the Magento 1 database. These will be used in the next migration step. Additional tables contain data about the changed records after the final migration execution. Triggers for databases are used to populate these extra tables, so if any operation is being performed on a particular table (a record is added/modified/removed), these database triggers save information about this operation to the extra table to keep track. When we run a delta migration process, the Magento Data Migration Tool checks these tables for any unprocessed records and then migrates the necessary data into the Magento 2 database.

    Each new table will have:

    • m2_cl prefix
    • INSERTUPDATEDELETE event triggers.

    For example, for the sales_flat_order the Magento Data Migration Tool creates:

    • m2_cl_sales_flat_order table:
    CREATE TABLE `m2_cl_sales_flat_order` (  `entity_id`, int(11) NOT NULL COMMENT ‘Entity_id’,  `operation`, text COMMENT ‘Operation’,  PRIMARY KEY (`entity_id`)) COMMENT=’m2_cl_sales_flat_order’;
    The Magento data migration tool saves its current progress as it runs. If any random error or user intervention stops the tool from running, the tool will resume progress at the last known active state. Use the –reset parameter to force the Data Migration Tool to run from the start. In this case, we recommend you restore your Magento 2 database dump to prevent duplicating the Data that was migrated previously.

    Possible consistency errors

    While running, the Data Migration Tool may report inconsistencies between Magento 1 and Magento 2 databases, you can search for their solutions or hire Magento developers to help you out.

    Data types that must be migrated manually.

    There are four kinds of information that must be migrated manually as the tool cannot migrate them:

    1. Media.
    2. Storefront design.
    3. Admin user accounts.
    4. Access Control Lists (ACLs).

    Media files stored in the database

    This section is only applicable to you if you store media files in the Magento database. These steps should be performed before the migration of data:

    1. Log in to Magento 1 as an administrator from the administrator channel.
    2. Click the System > Configuration > advanced > System.
    3. In the right panel, select the Storage Configuration for Media by scrolling down.
    4. From the list of  Select Media Database, click the name of the database used for media storage.
    5. Click Synchronize.

    Then, you will have to repeat the same steps in your Magento 2 Admin panel.

    Media files in the file system.

    All media files need to be copied manually by using the following command:

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

    Since Magento 2 has its independent .htaccess that should be preserved, you do not need to copy the .htaccess file located in the Magento 1 media folder.

    Storefront design

    • The design in files (CSS, templates, JS, XML layouts) changed its location and format
    • Layout Updates are stored in the database. Placed through Magento 1 Admin MS Pages, category pages, CMS widgets, and product pages.

    Access Control Lists (ACLs).

    You must manually re-create all:

    • Credentials  the for web service APIs that you avail (SOAP, XML-RPC, and REST).
    • Administrative user accounts and then associate them with access privileges.

    Once you have completed the migration and tested your new Magento 2 site thoroughly, you must perform the following tasks:

    • Reindex all Magento 2 indexers.
    • Put Magento 1 in maintenance mode and permanently stop all administrator activities.
    • Start Magento 2 cron jobs.
    • Change DNS, load balancers, etc. to point to Magento 2 production hardware.
    • Flush all Magento 2 cache types.

    What are the Advantages and Disadvantages of Magento 2 Data Migration Tool?


    • It is freeware and easily available for installation. You don’t have to pay for the software irrespective of the amount of data that needs to be migrated.
    • Magento has provided a very detailed instruction guide in form of documentation that helps developers. You can even follow their detailed step-by-step guides along the process, if you run into error you can hire Magento agency partners to help you out.
    • The tool also allows you to migrate the new data into your source cart to the target cart after the first migration with the delta data migration. This tool migrates data created only by Magento’s modules and is not responsible for the extensions nor code produced by any other third-party-party developers.


    • After the data update, you will have to put up the Magento 1 system in the maintenance mode so you can migrate over to the new site. Consequently, this will result in downtime on your main store that can affect the sales.
    • Apart from the documentation provided by Magento, it does not provide any support personnel. This means that users are solely responsible for the outcome of the migration process. Even though the users can seek help from the Magento community, they will only get unofficial answers so they are on their own. So it is better to hire Magento developers to perform Magento integration services or Magento Migration services.
    • In order to successfully run the Magento data migration tool, expertise and highly technical knowledge are expected from the users. This is because the process is extremely complicated and can lead to several catastrophic errors that prevent the migration from being successful and can even result in data loss. Therefore, it is crucial to hire Magento developers if you have no sound knowledge on your end.
    • Data loss on the new store occurs. At times, product images do not show up in the new target store which means that they could have been dropped off along the way. It is critical to back up the data beforehand, identify any new errors and then get them fixed on the target store. This process can be quite a resource and time-consuming.

    If you are making a new store, you should prefer building the store from scratch as compared to plain old migration. This is because the cost of migration and a little bit of added cost can get you a completely new store for your Magento 2 store. You can hire a Magento Web development company to provide you with a suitable package.

    How much does it cost to migrate to Magento 2?

    The cost of the migration depends upon the effort and the number of customizations on the original Magento 1 store. It also depends upon the developers. If you are migrating the store yourself, it must cost almost nothing but completely put your business at risk. The average cost with a default theme and no added extensions may take a couple of days and an estimated cost of $1500 to $2500. But since every store has some extensions and themes installed, the cost above may be an understatement. You can hire a Magento Web development company to perform the migration or even integration for some people who don’t want to abandon their previous stores.

    Does Folio3 provide Magento Migration Services?

    Folio3 is able to provide its customers with the best Magento migration services. If you are looking for a migration service for your Magento migration, you can use the services of Folio3. They have been dominating the market of e-commerce for the past decade thanks to their extensive benefits that leave their clients in the best position with respect to their e-commerce businesses.

    Provide the best migration solution.

    The company has certified Magento 2 developers. Their quality assurance engineers are able to uncover any loophole in the process and get it fixed. Folio3 has the ability to provide clients with the most effective migration models so that even after the solution has been developed, the client can reap the benefits of the solution that was customized as per their needs during the process. The company has over 25 active extensions that are certified by Magento themselves which shows their capabilities.

    Perform the migration at lower costs.

    Folio3  provides Magento migration solutions and Magento integration solutions at relatively lower costs than in the market. They are able to achieve efficiency all thanks to their expert developers. They get rid of redundant code and save the processing power and the memory required for the development of the solution. They make use of efficient coding practices to make sure that your migration is done as quickly as possible lowering the cost altogether.

    Timely delivery of the product.

    Folio3 has been developing e-commerce solutions for 15+ years, as a result, their employees have extensive experience in delivering projects well before the deadlines set by the clients. The company possesses experienced project managers who are easily able to manage the project team and deliver the solution in a timely fashion. This makes sure that the Magento store owner faces no delays in launching their store. So you can make use of Folio3 as your Magento Agency partners to make sure that your store is up and running as soon as possible after the integration.

    Safe and secure data transfer.

    The migration process is intricate. If this migration process is not managed as per the standard procedures, the entire database can be lost. All your Magento stores’ order records, history of the business, product details, and transaction records can be lost. If the process is not performed accurately, it is also possible that the data is exposed. This can result in the exposure of all your customer details. These details can be compromised and they can be misused. To prevent such disasters, Folio3 makes sure that your data is kept safe and secure.

    • The company follows international standards ISO 9001, so it also ensures that the databases are encrypted.
    • There is another data backup kept on the physical database. This results in increased safety. Even if the original database malfunctions due to any random error, there is another ready-to-use backup.
    • Folio3 keeps its databases secure from cyber-attacks. They are able to do so by having separate database servers that ensure that the data is not accessed by anyone and is under surveillance.
    • Database engineers of the company ensure that the databases are surveyed in real-time. They actively monitor the databases to bolster security and detect suspicious activity.

    Final Words

    You can migrate your Magento 1 store to a new Magento 2 store. You can use the Magento data migration tool if you have sufficient knowledge about programming and software. If you don’t possess such skills or simply don’t have the time, you can hire Magento agency partners to perform the migration services. You can also use Magento to hire Magento developers to maintain your store for the future.


    Q. What are the three data migration tools?

    A. There are three primary types of data migration tools that can be considered when migrating your data to a new target store:

    1. On-premise tools.

     These migration tools are designed to migrate data within the network of a large or medium enterprise installation physically present. These tools are ideally designed to migrate data between servers or databases, without moving data to the cloud and exposing it to any external threats. This tool is optimal if you are moving the location of your data repositories or changing data. It is also used when clients are bringing together data from different sources on-premise. Due to security restrictions, some companies prefer on-premise solutions. Some on-premise tools are Microsoft SQL, IBM infosphere, and Oracle data service integrator.

    2. Open Source tools.

    These tools are community-supported and can be free or for a very minimal cost. Open source tools can be used, modified, and shared because the design is publicly accessible. Some commercial products are built upon as open-source products and offer an open-source, limited version for download. The Open source data migration tools are an ideal option for migrating data only if your project is small or not complex. If you want to work with open-source, you will require some coding knowledge. A few of the most popular open-source data migration tools are CloverETL, Pentaho , Apache NiFi, and Talend open studio.

    3. Cloud-based tools.

     The tools are designed to transfer data to the cloud by using various streams and sources, these also include on-premise and cloud-based data stores, applications, and services. Cloud-based data migration tools are the most technologically advanced currently. Cloud-based solutions are best suited if you intend to move your data to the cloud or if you are already storing your data in the cloud. The majority of the companies see the reduced cost and increased security in transferring data from on-premise to cloud servers. The Cloud-based migration tools are very flexible with respect to the types of data they can handle for migration. Some popular cloud-based tools are Alooma, Fivetran, Matillion, and Snaplogic.

    Q. What is Magento Migration?

    A. Magento 1 to Magento 2 migration is called Magento migration. This service covers the transfer of design, database, extensions, and functionalities from Magento 1 to the Magento 2 platform. It requires technical expertise or else the results may be disastrous if not carried out correctly. To perform this migration, it’s best to hire Folio3 as your Magento agency partners.

    Q. Why Folio3, the best company for Magento migration services?

    A. Folio3 is able to provide migration solutions for businesses of all scopes. They provide Magento migration services like other companies. But what makes them stand out as experts as compared to others is that they are able to do so with added benefits. They are able to perform the migration at affordable prices by:

    • Decreasing the development time of the solution.
    • Using efficient code to decrease costs.
    • Eliminating any rework costs and making the solution in a single spiral run.
    • Removing redundancy in code to decrease resource consumption.

    You can visit the offices of Folio3 in the nearest country and discuss your requirement with them so that they are able to provide you with a package that is of high quality and affordable.


    Folio3, a Software Powerhouse established in 2005, is one of the leading eCommerce solution providers for SMBs and Fortune 500. The Company has expertise in diverse industries such as Animal Care, Retail, Automotive, Food and Agriculture, and Health care. From ecommerce store design and development to full-scale ERP deployment and integration, Folio3 has done it all.