Do not go further if you haven’t made a backup of your shop. Rollback will be the only way to go back if something does not go well, and this requires a backup. Learn how to backup your shop
There are a few ways of upgrading the PrestaShop store. This chapter provides information about two methods of getting the software to the latest version.
You can use provided
autoupgrade module to upgrade your store to the newest version using web interface. You can read more about the module and how to use it here.
Upgrade assistant module (autoupgrade) is fully accessible through
cli. You can read all the details here.
Manual upgrade without
autoupgrade module is not possible at the moment. We recommend using cli
mechanism from the upgrade assistant module.
This guide gives you the full control on the process. This one has been applied by PrestaShop for several major versions, and thus can be applied on very old shops.
The first step is to download the latest version on https://github.com/PrestaShop/PrestaShop/releases.
Download can also be done in command line, as done here with the version 8.0.2:
wget -O prestashop-upgrade.zip https://github.com/PrestaShop/PrestaShop/releases/download/8.0.2/prestashop_8.0.2.zip
Extract the files from the archive with a tool like 7zip
Note starting from PrestaShop 220.127.116.11, the release package contains a zip file itself, which must be extracted as well.
On a Linux terminal, you can use the command `unzip`:
unzip prestashop-upgrade.zip && unzip prestashop.zip
Once you have the folders like
themes/, etc. you may go on the next step.
Avoid overwrite the production resources (images, conf …) with the default data. These folders can be removed from the new release:
Also, rename the “admin” folder to match your shop’s admin folder name. This will prevent an unwanted duplication of the administration content.
The shop will now be modified. As it may cause unexpected behavior for you and your customers during the upgrade, we highly recommend you to turn on maintenance mode during the upgrade.
This can be done in your administration panel:
Adding your IP address will allow you to access your shop while it’s in maintenance mode. That way, you can make sure everything is working right before allowing your customers to access it again.
In this step, we “upgrade” the PrestaShop files by copying the new release content in the existing shop.
You may have activated a caching system (e.g. Memcache) on your shop. In that case, make sure to disable it in “Advanced Parameters” > “Performance”. You can enable it again once the upgrade process is done. You might want to also delete the
vendor folder: Previous upgrades of PrestaShop 1.7 showed that conflicts may occur when merging the new vendor/ folder with the old one.
To avoid this problem, we recommend to delete this folder in the existing shop before copying the new one.
rm -rf vendor/
On Windows, copy the new folder content and paste it in your shop folder. You will get warnings that files already exists in the destination folder. Choose “overwrite” to continue.
On linux, the copy can be done in your terminal:
cp -R <path_to_the_new_release>/* <path_to_the_current_shop>/
cp -R ~/Downloads/prestashop/* /var/www/html/
Once the files have been copied, your shop database is ready to be upgraded.
All the changes to apply have been defined in the
install folder, running them can be done with a specific PHP script.
When you’re ready, run the file
upgrade/upgrade.php from the
This can be done with a browser, by reaching the address
http://<shop_domain>/modules/autoupgrade/upgrade/upgrade.php, or from your
In both cases, an XML log will be displayed. The result can be found in the attribute
result of the first tag
okif updates have been found and executed
errorif something went wrong
infofor next actions, displaying the details on the process
When the upgrade script found some upgrades to apply, the SQL queries run will be listed along their respective result.
<?xml version="1.0" encoding="UTF-8"?><action result="ok" id=""> <action result="info" id="18.104.22.168"><![CDATA[[OK] PHP 22.214.171.124 : /* PHP:ps_update_tabs(); */]]></action> <action result="info" id="126.96.36.199"><![CDATA[[OK] SQL 188.8.131.52 : ALTER TABLE `ps_currency` MODIFY `name` varchar(64) NOT NULL]]></action> <action result="info" id="184.108.40.206"><![CDATA[[OK] SQL 220.127.116.11 : SET SESSION sql_mode = '']]></action> <action result="info" id="18.104.22.168"><![CDATA[[OK] SQL 22.214.171.124 : SET NAMES 'utf8']]></action> [...]
You can double check that each action is marked as “OK”. If not, additional details will be shown after the request, which can help you fix the issue and re-execute the request manually on your database. In some cases, you may need to restore your database backup and start over.
An error code can also be displayed. Each code is related to a message described here:
install/upgrade/sqlexist and is not empty?
Before going further, a few things should now be cleaned.
installfolder, used to run the database upgrades, is not needed anymore and can be safely deleted.
Reload them by force-refreshing the page (press ctrl+R on Windows / Linux or cmd+R on Mac OS) or clearing your browser’s cache.
Your modules files have been upgraded during the file copy, however many of them may require additional changes on the database. Please check the module page in your Back Office to see if upgrades are waiting to be run.
Go to your administration panel and login. You will notice the version displayed has changed on the login page. Then in the menu, click on the module page to reach your catalog.
On PrestaShop >= 1.7, this page can be found in the Improve >> Modules page, under the tab “Updates”:
Doing an upgrade by yourself can be risky. If you feel uncomfortable with doing it on your own, you can find support on prestashop-project.org.
Basically, the process and the result will be the same. The existing data on the shop will be kept, as well as your module and your current theme.
Many agencies and freelancers in your area may also provide this kind of service.
More information about support: PrestaShop project support page