Configure search

  • Updated

The Optimizely Configured Commerce search provider is Elasticsearch, which provides many search capabilities for your website. You configure these search capabilities through the Admin Console to tune your search results.

There are two Elasticsearch versions: 5.5 (Nest version 5) and 7.10 (Nest version 7). Configured Commerce defaults to version 5.5. You can change to version 7.10 from the search settings. Switching from version 5.5 to 7.10 applies default Search Index settings (you can update with version 5.5 settings if needed) and requires a Full Rebuild of the search index. The search provider are down until the index build is completed.

Configured Commerce does not have an out-of-the-box Hawksearch connector. Work with Hawksearch and your partner at the project level to implement it.

Search configuration

Configured Commerce provides a range of search settings you can use to tune your site's search results. Settings are under Administration > System > Settings in the Admin Console. See Search settings.


Located under Marketing > Stopwords, Stopwords are words eliminated from search results. Common stopwords like "And," "The," and "Or" are included in the base platform, but you also may choose to add industry-specific words or adjectives like "cheap." Stopwords affect all websites. See Work with stopwords.


Located under Marketing > Synonyms, use Synonyms to link words together, with omni- or bi-directional single-word connections. Synonyms affect all websites. See Work with synonyms.

Search Term Redirects

Located under Marketing > Redirects, Search Term Redirects allow Administrators to specify search terms that, when searched, automatically redirect to a given internal or external URL. For example, redirect the search term "customer portal" to the website's sign-in page. Configure these redirects for all or specific websites. See Search term redirects.

Boosting and Burying

Depending on business requirements, you can boost or bury particular product searches under the Marketing and Settings sections. See Boost and bury search results

Partial Match

You do not want to exclude possibly relevant results for multi-term searches. Set up Partial Match using Minimum Match Count and Minimum Match Percent settings. Determine whether a set number of words need to match or if a percentage of words in the description need to match for the result to display. For example, if you set the Minimum Match Count to three and Minimum Match Percent to 75% and a query has four terms, at least three must match, so the returned results must include the least or second-least frequent terms. This tuning of the search criteria contributes to the number and search quality of the returned search results but does not impact scoring. See Search settings.

Fuzzy Search or Misspellings

Configure Misspellings, often called "fuzzy search," using Fuzzy Search, Max Edits, and Prefix Length Settings to determine how a word can be matched. Calibrate Misspellings to determine the number of identical characters needed to match a word. Also, determine how many errors may be present in a word before the word no longer displays in search results. See Search settings.

Search History

Users within each browser session may be shown their last ten searches before they start typing in the search bar if Setting Search History Limit > 0. The number of past searches may be customized per website. See Search settings.


Elasticsearch has a robust stemming algorithm that provides a more forgiving set of query results. This means customers will have better success finding what they are looking for without worrying about entering the exact word forms in a search query.

Other than for a developer to turn it off, Stemming is not configurable, and applies to the English language only.

AutoCorrect and Did You Mean

Elasticsearch can auto-correct search words or offer suggestions to the user. You can turn this feature on or off at the application level. See Search autocorrect, and did you mean options.


The autocomplete menu allows users to see immediate results for Products, Categories, Content, News Summary and News Content as they type. They can go to a product without ever going to the search results. This can be configured per Website. See Search autocomplete.

Filtered Search Results

Search results can be filtered, narrowing the number of results shown. Keep adding search filters on top of previous ones to narrow the results. See Filter and search within results .

Special Characters

Enable the Search Non-AlphaNumeric Characters Setting to include non-alphanumeric characters in search results. This setting preserves non-alphanumeric characters and uses whitespace to split words. When disabled, non-alphanumeric characters are ignored. Additionally, the ERPNumber and Manufacturer Part Number fields each have an entry in the search index that removes special characters and does not replace them with a space regardless of the Search Non-AlphaNumeric Characters Setting. This is especially useful when working with hyphenated product numbers so that the hyphen is not converted to a space. See Search settings .