Magento 2 Upgrade Checklist: Safe Steps for 2.4.x Updates

Magento upgrades break when the process is rushed. Use this checklist to reduce surprises and keep the release controlled.

Before you upgrade

• Take full backups (DB + code + media).
• Freeze deployments during the upgrade window.
• List all third-party modules and check compatibility.
• Confirm PHP version, Elasticsearch/OpenSearch, and MySQL/MariaDB requirements.

Upgrade steps (high level)

1. Create a new branch (never upgrade directly on main).
2. Run composer update for Magento metapackage.
3. Resolve dependency conflicts.
4. Deploy to a staging environment and run:

bin/magento maintenance:enable
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/magento cache:flush
bin/magento maintenance:disable

Post-upgrade checks

• Category pages, product pages, cart/checkout.
• Customer login + account pages.
• Search, layered navigation, and filters.
• Cron health and queue consumers (if used).

Release tips

Always keep a rollback plan: DB restore, code revert, and cache reset procedures documented before you start.