Cannot change Search Engine using Commerce Admin (Search Engine menu is inaccessible)

Last update: July 3, 2024

CREATED FOR:

  • Developer
WARNING
MySQL catalog search engine will be removed in Adobe Commerce 2.4.0. You must have Elasticsearch host setup and configured prior to installing version 2.4.0.

This article provides a solution for changing the Adobe Commerce Search Engine using the Commerce Admin if the Search Engine field is not displayed or the Use system value checkbox is greyed out and not accessible.

In this article:

Affected versions

  • Adobe Commerce on-premises: 2.4.X

  • Adobe Commerce on cloud infrastructure:

    • Version: 2.4.X
    • Starter and Pro plan architecture

  • MySQL, Elasticsearch, Opensearch, Live Search: all supported versions

Change Search Engine using the Admin (steps)

  1. Log in to the Admin as an Administrator.
  2. On the left-side of the Admin sidebar, click on Stores.
  3. Under Settings, choose Configuration.
  4. Navigate to the panel on the left under Catalog, and choose Catalog.
  5. Expand the Catalog Search section. catalog_menu.png
  6. Go to the Search Engine field and remove selection from the Use system value checkbox.
  7. Click the Search Engine menu and select one of the available options as shown below. search_engine_menu.png
  8. Click on Save Config in the top-right hand corner of the page.

Issues with Adobe Commerce on-premises

Issue 1: Search Engine field is not displayed

When you access the Catalog Search section, the Search Engine menu is not displayed at all.

search_engine_not_displayed.png

Cause: Store View is not Default Config

The Store View for the Admin has been set to any value other than Default Config.

The search engine is a global configuration set on the application level, not on the Store Scope. Stores within an Adobe Commerce application cannot use different search engines.

Solution: Set Store View to Default Config

  1. Log in to the Admin as an Administrator.
  2. On the left-side of the Admin sidebar, click on Stores.
  3. Navigate to Settings and choose Configuration.
  4. In the upper-left hand corner, click the Store View selector and choose Default Config.
  5. Click on OK in the confirmation dialog box to approve the store view changes.

change_store_view.png

Related documentation: Changing Scope in our user guide.

Issue 2: Cannot uncheck “Use system value”

When you access the Catalog Search section of the Admin, the Use system value checkbox is greyed out so you cannot remove selection from the checkbox to later change the search engine.

Cause

The default search engine has been configured on the application configuration level in the app/etc/env.php or app/etc/config.php files and thus cannot be changed using the Admin.

Example of the section with default search engine configuration:

'system'=>
array (
'default'=>
array (
'catalog'=>
array (
'search'=>
array (
'engine'=>'mysql',
),
),
),
),