Search settings

  • Updated

Optimizely Configured Commerce offers several settings for tuning and improving search performance.

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.

You must complete a full index rebuild to apply any changes to search settings.

  1. Go to Marketing > Indexing in the Admin Console.
  2. Click Rebuild All to rebuild all, or click Full Rebuild for the product or content search index category.

Admin Console settings

You can find these settings in the Admin Console under Settings > Search.

General

  • Attribute Filters – Customers can use attributes (attribute values grouped by attribute type) on the left menu of the product list as filters. This does not control category or price faceting. You must reindex for changes to this setting to take effect. The default value is On.
  • Hide Facets Until Category Selected – Filters for attribute facets do not display in search results unless the user selects a category. The default value is No. This setting only displays if Attribute Filters is set to On.
  • Show Attributes on Search – Attribute facets display for search results, not just category pages. The default value is No.
  • Search History – Users see their previous searches when they click on the search box and nothing is in it. The default value is On.
  • Search History Limit – The number of previous searches that display to the user when they click on the search box and nothing is in it. The default value is 10. This setting only displays if Search History is On.
  • Search Non Alphanumeric Characters – Non-alphanumeric characters are preserved, and whitespace is used to split words. If Off, non-alphanumeric characters are ignored. The default value is Off.
  • Log Product Search Queries – Product search queries are included in the Application Logs. This should only be used by developers and results in a lot of data if enabled. The default value is No.
  • Maximum Attribute Facets – The maximum total number of attribute values that are displayed across all attribute types in the product list. By default, each attribute type displays five attribute values, which users can expand to show the full list of attribute values. This setting does not affect that behavior. The default value is 1000.
  • Stopword Mode – What list of common words are excluded from search queries. You must reindex for changes to this setting to take effect. The default value is Custom.
    • Custom – Uses the list from Search > Stopwords in the Admin Console.
    • Default – Uses the internal list of English Lucene stopwords.
    • None – Does not use stopwords.
  • Website Specific Attributes – If On, only attribute types assigned to categories in the website are faceted, which can impact performance. If Off, faceting is across all valid attribute values for each product, regardless of the site. You must reindex for changes to this setting to take effect. The default value is Off.
  • Search Provider Name – The name of the search provider. Choose from Commerce Search v1 (formerly Elasticsearch), Commerce Search v2 (formerly Elasticsearch v7), or Commerce Search v3 (beta).
  • Search Indexer Name – The name of the search indexer. Choose from Commerce Search v1 (formerly Elasticsearch), Commerce Search v2 (formerly Elasticsearch v7), or Commerce Search v3 (beta).
  • Enabled Nested Documents – Nested documents are queried, analyzed, sorted, retrieved, aggregated, and highlighted. The default value is No.

Autocomplete

  • Autocomplete – Users see the autocomplete drop-down list as they type in the search box. The default value is On.
  • Show Categories – Category autocomplete results display as the user types in the search box. The default value is Yes.
  • Show Website Pages – CMS pages display as autocomplete results as the user types in the search box. The default value is Yes.
  • Show Products – Product autocomplete results display as the user types in the search box. The default value is Yes.
  • Show Brands – Brand autocomplete results display as the user types in the search box. The default value is Yes.

Boosting

  • Product Boosting – If On, specific products can be boosted to display higher or lower in search results. If Off, product boosting values are ignored. The default value is On.
  • Enable Boosting by Purchase History – Products purchased within a defined lookback period are boosted in search results. The default value is No.
  • Lookback Months for Purchase History Boosting – Customer purchases within this number of months are used to identify products to boost based on purchase history. Increasing this value increases the time it takes to rebuild the search index. The default value is 6.
  • Frequently Purchased Threshold – The number of times a customer must have purchased a product within the defined lookback months to consider it "Frequently Purchased" for boosting. The default value is 3.
  • Boost Amount for Frequently Purchased Products – The multiplier applied to search result scoring for products purchased more than the frequently purchased threshold. This value is included with the values for matches for all indexed fields and other boosting options to determine the search score and rankings. The default value is 3.
  • Boost Amount for Less Frequently Purchased Products – The multiplier applied to search result scoring for products purchased recently but not enough to be considered frequently purchased. This value is included with the values for all matches for other indexed fields and other boosting options to determine the search score and rankings. The default value is 1.5.
  • Allow Filtering for Previously Purchased Products – Users can filter search results or category product lists to only see products that they have previously purchased, based on data available in the order history table. The default value is Yes.

Shared Fuzzy Search (misspellings)

  • Fuzzy Search – Fuzzy search is enabled on the site. The default value is On.
  • Max Edits – The maximum number of character edits that can be made to a search string to return a match. This can be either a character swapped for a different character or a character being added or removed. The default value is 1.
  • Prefix Length – The number of initial characters that must match and will not be fuzzified. A value below 2 results in performance issues. The default value is 2.

Shared Partial Matching

  • Minimum Match Count – The minimum number of words that must match to return a result. Negative numbers indicate the number of optional words. Works in conjunction with Minimum Match Percent. The default value is 2.
  • Minimum Match Percent – The percentage of optional words in a search term that must match to return a result. Negative numbers indicate the percent of optional words that can be missing. This works in conjunction with Minimum Match Count. The default value is 75.

Search index

  • Batch Size for Indexing – The number of records to send to Elasticsearch in each request during indexing. Reindexing is required for changes to this setting to take effect. The default value is 250.
  • Concurrent Requests for Indexing – The number of concurrent requests to make to Elasticsearch during indexing. Reindexing is required for changes to this setting to take effect. The default value is 8.
  • Enable Ngram – Product number and manufacturer item values are indexed using ngram indexing. This indexes segments of the values to return relevant results for partial matches. For example, if your product numbers are formatted like ABC12345 and your customers normally search for only the numeric segments, 12345 are indexed and return a product match in searches. Values are indexed with and without special characters included. The default value is No.
  • Minimum Ngram Length – The smallest number of characters of ngram segments to be indexed. This should match the smallest search term length that your customers would search for matches on product numbers. For performance reasons and to prevent erroneous matches, the minimum value is 3. The default value is 5.
  • Maximum Ngram Length – The largest number of characters of ngram segments to be indexed. This should match the largest character length of your product numbers. For performance reasons and to prevent erroneous matches, the minimum value is 3. The default value is 8.
  • Enable Product Number Tiebreaker – This feature sorts product search returns by product number to handle ties in the search term results when the relevance score is identical. The default value is No.
  • Enable Force Merge – A force merge is performed after building indexes. This adds some build time but provides consistent search results. The default value is Yes.

 Shared Search Suggestions

  • Enable Search Suggestions – AutoCorrect and DidYouMean are configurable on the site. The default value is On.
  • Enable AutoCorrect – This setting enforces the autocorrect threshold and part number settings. The default value is Yes.
  • AutoCorrect Threshold – The minimum confidence level at which searching on a mistyped phrase automatically searches on a corrected phrase. A value of 1 means the corrected phrase must have a closer match to the product data than the original phrase. Higher numbers require an even better match to apply the correction. The value must be higher than or equal to the DidYouMean Threshold. The default value is 2.
  • Exclude Part Number from AutoCorrect – An exact match on a part number prevents Commerce Search from autocorrecting the search query. The default value is Yes.
  • Enable DidYouMean – This setting enforces the DidYouMean threshold setting. The default value is Yes.
  • DidYouMean Threshold – The minimum confidence level at which searching on a mistyped phrase presents a suggested phrase correction but searches on the original phrase. A value of 1 means the corrected phrase must have a closer match to the product data than the original phrase. Higher numbers require an even better match to apply the correction. This must be lower than or equal to the AutoCorrect Threshold. The default value is 1.
  • Max Edits – The maximum number of characters that can be changed on a word to be considered as a suggestion. The default value is 2.
  • Max Errors – The maximum number of errors that can be corrected when generating suggestions. A decimal between 0 and 1 indicates a percentage of words that can be corrected. Whole numbers greater than or equal to 1 can be used to specify the exact number of words that can be corrected. Numbers higher than 2 may have a negative impact on performance. The default value is 0.3.

Sponsored Search

  • Sponsored Search – Specific products can be flagged as sponsored and boosted to the top of search results. The sponsored flag is set for individual products in the product boosting page. The default value is On.
  • Sponsored Search Limit – The maximum number of sponsored products matching the search query that are displayed at the top of search results. The maximum value is 5. The default value is 3.