Migrate data

Before you start: routine preparations

  1. Log in to Magento server as the file system owner.

  2. Change to the Magento installation directory or make sure it is added to your system PATH.

See the First steps section for more details.

Run the data migration command

To start migrating data, run:

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


  • [-a|--auto] is an optional argument that prevents migration from stopping when it encounters integrity check errors.

  • [-r|--reset] is an optional argument that starts migration from the beginning. You can use this argument for testing migration.

  • {<path to config.xml>} is the absolute file system path to config.xml; this argument is required

The Data Migration Tool saves its current progress as it runs. If errors or user intervention stop it from running, the Tool resumes progress at the last known good state. To force the Data Migration Tool to run from the beginning, use the --reset argument. In that case, we recommend you restore your Magento 2 database dump to prevent duplicating previously migrated data.

Possible consistency errors

While running, the Data Migration Tool may report inconsistencies between Magento 1 and Magento 2 databases, and display messages like this:

Source documents are not mapped: <EXTENSION_TABLE>

See the Troubleshooting section of this guide for more information and recommendations.

Next migration step

Migrate changes