You are browsing upcoming documentation for version 6.1 of OroCommerce, scheduled for release in 2025. Read the documentation for version 6.0 (the latest LTS version) to get up-to-date information.

See our Release Process documentation for more information on the currently supported and upcoming releases.

Configure Storefront Fuzzy Search Settings per Website 


The feature is available for the Enterprise edition only.


Read Search Functions Concept Guide to get a general understanding of the search functionality in OroCommerce.

You can set up storefront error-tolerant (fuzzy) search in website search index requests to Elasticsearch. When enabled, it finds similar results for the passed request phrase word by word. Please be aware that this feature is not supported by the ORM search engine. For configuration options to set up fuzzy search in the back-office, see the General Setup Configuration topic.


Storefront fuzzy search configuration options are also available on the global level.

To configure storefront fuzzy search settings:

  1. Navigate to System > Websites in the main menu.

  2. For the necessary website, hover over the more actions menu to the right of the necessary website and click to start editing the configuration.

  3. Select Commerce > Search > Fuzzy Search in the menu to the left.


For faster navigation between the configuration menu sections, use Quick Search.

Storefront fuzzy search configuration options on the website level
  1. You can enable or disable the following options (clear the Use Organization checkbox to customize the settings):

    • Enable Fuzzy Search — enables fuzzy search in the appropriate area. This option is disabled by default.

    • Error Tolerance — sets how many errors in each word the application ignores. Possible values are:

      • One Error (default) – one error per word is tolerated

      • Two errors – two errors per word are tolerated

      • Request based – tolerance depends on the length of the word. One error for short words (up to 5 characters) and two errors for long words (6+ characters).

    • Tolerance Starts From — sets a threshold for error-tolerant search usage. The default value is 4, which means that the application uses the exact match search for words with 1-3 characters and an error-tolerant search for words with 4+ characters.

    • Tolerance Exclusions — allows setting regular expression for words that must not use error-tolerant search; the exact match search is used instead. This option is beneficial for SKUs, manufacturer IDs, and other identifiers that may have similar values and lead to false-positive results when the error-tolerant search is used.

Fuzzy search with 2 errors illustration