Magento Commerce, 2.2.x

Magento 2.2.x Notice: As outlined by the Magento Software Lifecycle Policy, Magento 2.2.x has reached the End-of-Support and will no longer receive quality fixes or documentation updates. To maintain your site's performance, security, and PCIPayment Card Industry: Refers to debit and credit cards and their associated businesses. compliance, upgrade to the latest version of Magento.

The online Magento 2.2.x User Guide is scheduled for removal, but will remain available in PDF for Open Source, Commerce, and Commerce for B2B.

System Upgrade

The System Upgrade tool can be used to upgrade your Magento installation from the AdminThe password-protected back office of your store where orders, catalog, content, and configurations are managed.. The upgrade is a three-step process that should take place during off-peak hours. Before upgrade takes place, your store is put into maintenance mode, checked for readiness, and backed up.

We strongly recommend reviewing the latest release notes and system requirements.

Upgrade Requirements

Caching and Reindexing

Always flush the cache when upgrading from one version of Open Source or Commerce to another. Two upgrade examples include: upgrading from Magento Open Source 2.1.X to 2.2.X and upgrading from Magento Open Source 2.2.X to Magento Commerce 2.2.X.

Important: Always flush the cache after installing or upgrading Magento, or any extensions and modules.

For developer information on upgrades, see the DevDocs Command Line Upgrade. The upgrade instructions include scripts to help run and complete your upgrades. These steps will require developer assistance.

System Upgrade

To upgrade your Magento installation:

1. Log in to the Admin of your Magento store as a user with full administrator rights.
2. On the Admin sidebar, tap System. Then under Tools, choose Web Setup Wizard.

Web Setup Wizard
3. Tap Extension Manager.

System Upgrade
4. When prompted, follow the instructions to copy and paste the Public Access Key and Private Access Key from your Marketplace account. Then, tap Submit.
5. Follow the onscreen instructions to complete the following steps:
  • Step 1: Select Version
  • Step 2: Create Backup
  • Step 3: System Upgrade.
6. Flush the cache and reindex when complete.