How to update PrestaShop

Updating PrestaShop is essential for maintaining the security, speed, and modern functionality of your online store. New versions patch vulnerabilities, optimize database queries, and ensure compatibility with the latest PHP versions and web standards.

Context

PrestaShop updates can be complex due to the deep integration of third-party modules and custom themes. Following a disciplined update protocol-starting with a robust backup-is the best way to prevent downtime and data loss.

Phase 1: Preparation (Critical)

Never start an update on a live environment without these precautions:

1. Check Your Version: Identify your current version in Advanced Parameters > Information.
2. Verify Compatibility: Ensure your theme and core modules (especially payment and shipping) support the version you are moving to.
3. Perform a Full Backup:
   • Files: Download all files via FTP or use the backup tool in your mybox panel.
   • Database: Export your database via phpMyAdmin.
4. Enable Maintenance Mode: Go to Shop Parameters > General > Maintenance to prevent customers from placing orders during the update process.

Phase 2: Update Methods

Method 1: The “1-Click Upgrade” Module (Recommended)

This is the official and most efficient way to update for most users.

1. Install the Module: Find “1-Click Upgrade” in your Module Manager and install it.
2. Configure Checklist: The module will perform a pre-check. Ensure all green checkmarks are present (e.g., maintenance mode is on, file permissions are correct).
3. Run the Upgrade: Click Upgrade PrestaShop now. The module will automatically download the files, replace them, and run the necessary database scripts.
4. Verification: Once complete, check your front-end and back-office for any errors before disabling maintenance mode.

Method 2: Manual Update

Use this only if the 1-Click module is incompatible with your server environment.

1. Download & Extract: Get the latest version from the official PrestaShop site and unzip it.
2. Upload via FTP: Upload the new files to your server, overwriting existing files.
   • Warning: Do not overwrite your /img folder or your configuration files (e.g., settings.inc.php in older versions or the /app/config folder in 1.7+).
3. Run Upgrade Script: Navigate to [yourdomain.com/install/upgrade/upgrade.php](https://yourdomain.com/install/upgrade/upgrade.php) in your browser and follow the prompts.
4. Cleanup: Delete the /install folder from your server immediately after the process finishes.

Phase 3: Post-Update Troubleshooting

If you encounter issues after the update, check these common areas:

• 500 Internal Server Error: Enable Debug Mode in Advanced Parameters > Performance. This will reveal the specific file or module causing the error.
• Missing Images: Go to Design > Image Settings and use the Regenerate thumbnails tool.
• CSS/Layout Issues: Clear all caches in the Performance tab and clear your browser’s local cache.
• Module Conflicts: If the store crashes, try disabling non-essential modules one by one until the site stabilizes.

Distinction: Minor vs. Major Updates

• Minor Updates (e.g., 8.1.1 to 8.1.2): Usually focus on security and bug fixes. These are low-risk and highly recommended.
• Major Updates (e.g., 1.7 to 8.0): These involve significant architectural changes. These should always be tested on a “Staging” or development copy of your site first.

Summary

A successful PrestaShop update is all about the quality of the preparation. By using the 1-Click Upgrade module and verifying compatibility beforehand, you can keep your store secure and efficient with minimal risk.