You must install and configure Elasticsearch 7.6.x before upgrading to Adobe Commerce or Magento Open Source 2.4.0. See Check the catalog search engine for details.

Check the catalog search engine

Before you upgrade from Magento 2.3.x to Magento 2.4, you must check whether you are using MySQL, Elasticsearch, or a third-party extension as your catalog search engine in your Magento 2.3.x instance. The result determines what you must do before upgrading to Magento 2.4.

You can use the CLI or the Admin to determine your catalog search engine:

  • Enter the bin/magento config:show catalog/search/engine command. The command returns a value of mysql, elasticsearch (which indicates Elasticsearch 2 is configured), elasticsearch5, elasticsearch6, elasticsearch7, or a custom value, indicating you have installed a third-party search engine.

  • From the Admin, check the value of the Stores > Settings > Configuration > Catalog > Catalog > Catalog Search > Search Engine field.

The following sections describe what actions you must take before upgrading to Magento 2.4.0.


Magento 2.4 no longer uses MySQL as a catalog search engine. You must install and configure Elasticsearch before upgrading. Use the following resources to help guide you through this process:

Some third-party catalog search engines run on top of Magento’s search engine. Contact your vendor to determine whether you need to update your extension.


You must install and configure Elasticsearch before upgrading to Magento 2.4.0. Magento does not support Elasticsearch 2.x, 5.x, and 6.x.

Refer to Upgrading Elasticsearch for full instructions on backing up your data, detecting potential migration issues, and testing upgrades before deploying to production. Depending on your current version of Elasticsearch, a full cluster restart may or may not be required.

Elasticsearch requires JDK 1.8 or higher. See Install the Java Software Development Kit (JDK) to check which version of JDK is installed.

Configure Magento to use Elasticsearch describes the tasks you must perform after updating Elasticsearch 2 to a supported version.

Third-party extensions

Magento recommends that you contact your search engine vendor to determine whether your extension is fully compatible with Magento 2.4.