Checklist before a PrestaShop migration
A PrestaShop migration that goes wrong is almost always one that was poorly prepared beforehand. Here’s what I systematically check before touching a single file, whatever the starting or target version.
Why this step isn’t optional
A migration is prepared before it starts, not during. If the inventory is incomplete, problems surface along the way, often at the worst moment: a module whose licence has expired, a code override nobody remembers, a database backup that turns out not to contain everything. Each of these oversights costs time, and sometimes unrecoverable data.
This checklist applies to any pair of PrestaShop versions, from 1.5 to 9. What changes from one migration to another is the scale of the rebuild work; what doesn’t change is the need to start from a complete inventory and a reliable backup.
What I inventory and back up
-
Full list of installed modules
Name, publisher and exact version number of every module, including disabled ones still present. This is the basis for later checking which ones have a compatible equivalent for the target version.
-
Inventory of code overrides
Everything in the override/ folder, plus custom hooks added outside standard modules. These customisations are the most fragile point during a major version change.
-
Full database backup
Structure and content of every table, not just product and order tables. Configuration, translation and module tables hold settings you don’t want to re-enter by hand.
-
Full file backup
Code, theme and catalogue images. A database without its associated image files is unusable as it stands.
-
Target PHP version at the host
I check which PHP version is available at the host, and whether it matches what the target PrestaShop version requires. This is often the constraint that decides which target version is actually possible.
-
Scheduled tasks, API keys and translations
Existing cron jobs (cart reminders, exports, synchronisations), payment and carrier API keys, and any language modules and custom translations installed.
-
Available disk space
I check there’s enough room to store the full backup and run a test copy alongside the live site.
Related pages
-
Incompatible modules after a migration
Why a module that worked perfectly breaks after an update, and how to check its compatibility before migrating.
-
Migrating without interrupting sales
The method for preparing a migration alongside the live site, and switching over without taking the shop offline.
-
Moving PrestaShop to PHP 8
What it means when a host drops PHP 7 and the target PrestaShop version requires PHP 8.
Describe your need in one minute
A few targeted questions so I can reply with an estimate rather than another questionnaire.