Migration overview


We’re pleased you’re considering moving from the world’s #1 commerce platform — Magento 1.x — to the platform for the future, Magento 2. We’re also excited to share the details about this process, which we refer to as migration.

Migration components

Magento 2 migration involves four components: data, extensions and custom code, themes, and customizations.


We’ve developed the Magento 2 Data Migration Tool to help you efficiently move all of your products, customers, and order data, store configurations, promotions and more to Magento 2. This guide provides information on the tool and best practices for using it to migrate your data.

Extensions and custom code

We’ve been working hard with the development community to help you use your Magento 1 extensions in Magento 2. Now we’re proud to present the Magento Marketplace, where you can download or purchase the latest versions of your favourite extensions.

Also, we have developed the Code Migration Toolkit, which will help to port your extensions and custom code to Magento 2, significantly reducing your efforts.

More information on developing extensions for Magento 2 is available in the PHP Developer Guide.

Themes and customizations

Magento 2 uses new approaches and technologies that give merchants an unmatched ability to create innovative shopping experiences and scale to new levels. To take advantage of these advances, developers will need to make changes to their themes and customizations. Documentation is available online for creating Magento 2 themeslayouts, and customizations.

Migration efforts

Just like an upgrade between 1.x versions (for example, from v1.12 to v1.14), the level of effort to migrate from Magento 1 to Magento 2 depends upon how you have built your site and its level of customization. Initial estimates indicate that an average Magento 2 migration is only about 20% larger than a Magento 1.x upgrade.

However, we are constantly improving the Data Migration Tool (see the Changelog for more details); so the migration efforts are continuously decreasing.