After July 2021, the 2.3.x release line no longer received quality updates or user guide updates. PHP 7.3 reached end of support in December 2021, and Adobe Commerce 2.3.x reached end of support in September 2022. We strongly recommend upgrading to Adobe Commerce 2.4.x to help maintain PCI compliance.
Configuring Catalog Search
This site contains archived merchant documentation for a version of Adobe Commerce and Magento Open Source that has reached end-of-support.
The documentation available here is intended for historical reference only and is not maintained.
The Adobe Commerce Merchant Documentation for current releases is published on the Adobe Experience League.
Magento offers a choice of search engines and versions and supports both MySQL and Elasticsearch. The search engine configuration includes a set of general settings and additional features specific to the search engine. By default, Magento uses the MySQL search engine.
MySQL
MySQL is the default search engine used by Magento.
Elasticsearch
Elasticsearch is a powerful and highly scalable distributed search engine that is used by many industry leaders with high-volume sites.
General search options
All search engines include a set of search options.
| Option | Scope | Description |
|---|---|---|
| Minimal Query Length | Store View | The minimum number of characters allowed in a catalog search. The value set for this option must be compatible with the corresponding range set in your selected search engine configurations. For example, if you set this value to 2 in Magento, update the value in your search engine. |
| Maximum Query Length | Store View | The maximum number of characters allowed in a catalog search. The value set for this option must be compatible with the corresponding range set in your selected search engine configurations. For example, if you set this value to 300 in Magento, update the value in your search engine. |
| Number of top search results to cache | Store View | The number of popular search terms and results to cache for faster responses. Entering a value of 0 caches all search terms and results when entered a second time. Default value: 100 |
| Autocomplete Limit | Store View | The maximum number of search results to display for search autocomplete. Restricting this amount increases performance of searches and reduces the displayed list size. Default value: 8 |
| Enable Search Suggestions | Store View | Determines if search suggestions appear for common misspellings. When enabled, search suggestions are offered for any request that returns no results. Search suggestions can impact the performance of search. Options: Yes / No. |
When set to Yes, additional options are displayed for Enable Search Recommendations and associated fields. |
||
| Search Suggestions Count | Store View | The maximum number of search suggestions offered. Default value: 2 |
| Show Results Count for Each Suggestion | Store View | Determines if the number of search results is shown for each suggestion. Depending on theme, the number usually appears in brackets after the suggestion. Options: Yes / No |
| Enable Search Recommendations | Store View | Determines if search recommendations are offered when a search returns no results. Options include: Yes / No. When set to Yes, additional options are displayed for Search Recommendations Count and Shows Results Count for Each Recommendation. |
| Search Recommendations Count | Store View | Specifies the number of search terms offered as recommendations. By default, no more than five are shown. |
| Show Results Count for Each Recommendation | Store View | When set to Yes, the number of products found for the proposed search recommendation is shown in the brackets. Options: Yes / No |