You are browsing documentation for version 5.1 of OroCommerce, supported until March 2026. 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 Global Storefront Fuzzy Search Settings 


The feature is available for the Enterprise edition only.

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.


You can also configure storefront fuzzy search on the website configuration level.

To configure storefront fuzzy search settings:

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

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


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

Global fuzzy search configuration options for the storefront
  1. Configure the following options:

    • 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.