PHP 7.3 reaches end of support in December 2021 and Adobe Commerce 2.3.x reaches end of support in April 2022. You may want to consider planning your upgrade now to Adobe Commerce 2.4.x and PHP 7.4.x to help maintain PCI compliance.

Data that needs to be migrated manually

Data types

There are four kinds of data that need to be migrated manually:


This section discusses how to manually migrate media files.

Media files stored in the database

This section applies to you only if you store media files in the Magento database. This step should be performed before migration of data:

  1. Log in to the Magento 1 Admin Panel as an administrator.

  2. Click System > Configuration > ADVANCED > System.

  3. In the right pane, scroll to Storage Configuration for Media.

  4. From the Select Media Database list, click the name of your media storage database.

  5. Click Synchronize.

Then, repeat the same steps in your Magento 2 Admin panel.

Media files in the file system

All media files (images for products, categories, the WYSIWYG editor, and so on) should be copied manually from <your Magento 1 install dir>/media to <your Magento 2 install dir>/pub/media.

However, do not copy the .htaccess files located in the Magento 1 media folder. Magento 2 has its own .htaccess that should be preserved.

Storefront design

  • Design in files (CSS, JS, templates, XML layouts) changed its location and format

  • Layout Updates stored in database. Placed through Magento 1 Admin in CMS Pages, CMS Widgets, Category Pages and Product Pages

Access Control Lists (ACLs)

You must manually re-create all:

  • credentials for web service APIs (SOAP, XML-RPC, and REST)

  • administrative user accounts and associate them with access privileges

You may adjust the time zone for a database entity using the \Migration\Handler\Timezone handler. See the Follow-up section for more details.

Related topics