Search settings

Manage company-specific catalog search settings and the boost, priority, and query type of attributes used in search.

The Search settings screen consolidates the settings that determine how the store search behaves in one place. In the General settings tab, you manage company-specific catalog search settings (such as minimum search term length, redirecting to category, fuzzy match limits), and in the Attribute settings tab, you manage which product attributes are used in search and how much weight they carry. Since these settings affect all search results, make changes carefully and in small steps.

Accessing the screen

Follow the menu path Searchandising › Setup › Search settings.

If you do not see it in the menu, your account does not have permission for this screen. If you can see the screen but the General settings fields are inactive, the Save and Add attribute buttons are not visible, and the edit button in attribute rows is replaced by "—", your account does not have permission to change settings; you can only view them.

Screen sections

  1. Title: Search settings, with the description "Catalog search behavior and attribute searchability." below.
  2. Company selection and Reload: to the right of the title. The company box lists companies with website integration in the format "Name (IP: IDs)"; if a company has multiple integrations, IDs are separated by commas. The Reload button reloads the settings.
  3. Tabs: General settings and Attribute settings. The number of searchable attributes is shown next to the second tab.
  4. Tab content: the card of the selected tab.

The open tab and company selection are written to the page address; when you refresh the page or share the link, the same tab and company open.

Company selection only affects the General settings tab. Attribute settings do not vary by company; they are common for all attributes in your setup.

General settings

The Catalog settings card contains the catalog search settings for the selected company. When the screen opens, a company is selected by default; before making changes, verify that the correct company is selected in the company box in the header.

Field Required Description / rule
Minimum search term length Yes The minimum number of characters required to start a search in the search box; shorter searches are not triggered (e.g., if 3, "ab" is not searched, "abc" is searched). Integer between 1 and 20. If no saved value, 3 is shown.
Redirect term to category — If Yes is selected, when the search term exactly matches a category, the customer is taken directly to that category page (e.g., "boot" → Boot category). Yes / No; if no saved value, No is shown.
Attribute boost multiplier (1-500) Yes The weight multiplier of attribute matches in ranking; higher values boost attribute matches in ranking. Integer between 1 and 500. Default is 50.
Exact match length limit Yes Words up to this length are searched only by exact match; fuzzy search on short words produces many incorrect results. Integer between 1 and 20. Default is 3.
Fuzzy match length limit Yes Words up to this length allow 1 letter difference; longer words allow 2 letter differences. Integer between 1 and 20. Default is 5.

Saving catalog settings

  1. Verify the correct company is selected in the company box in the header.
  2. Edit the fields you want to change.
  3. Click the Save button at the bottom of the card (pressing Enter in a numeric field also saves).

If saving is successful, a "Saved" notification appears and the settings are reloaded. If there is an error, a red Something went wrong notification shows error details and your entered values remain.

Notes:

  • If a field is empty, not an integer, or out of range, a warning "Enter an integer between 1 and 20." (for boost multiplier "Enter an integer between 1 and 500.") appears below the field and Save remains inactive.
  • Fields are not cross-validated. You should ensure Exact match length limit is not greater than Fuzzy match length limit.
  • If you change the company before saving, fields show the saved settings of the new company. Save your changes before switching companies.
  • Changes are saved without confirmation and there is no undo button. To revert, restore the old value and save again; it is recommended to note current values before changing.

Attribute settings

The Attribute settings card lists attributes used in search (searchable). Attributes not marked searchable do not appear in this list.

Column Meaning
Attribute Name of the attribute.
Searchable Indicates the attribute is used in search. Since only searchable attributes are listed, this shows Yes.
Boosts Weight multiplier of the attribute in search results; higher values are more effective. If undefined, shows "—".
Priority Match priority (1–10). If the same word matches multiple attributes, the one with higher priority wins. If undefined, shows "—".
Query type How the attribute behaves in search: must (mandatory), filter (filter), should (prefer). If undefined, shows "—".
Actions Edit (pencil) button. If you lack edit permission, shows "—".

Adding an attribute to search

Use this when you want to make an attribute (e.g., color or material) searchable.

  1. Click the Add attribute button at the top right of the card. The Add attribute dialog opens.
  2. Select the attribute from the Attribute box. Options are in "Name (ID: IDs)" format; the list loads when the box opens.
  3. Fill in the Boosts, Priority, and Query type fields. The dialog opens with default values 1, 5, and must respectively.
  4. Click Add and save.

If saving is successful, a "Attribute added." notification appears, the dialog closes, and the list refreshes. The added attribute is marked searchable. Saving is done without confirmation.

The selection list shows all attributes including those already searchable. If you select an attribute already in the list and save, its current search settings are overwritten with the dialog values; to avoid losing previous values, edit those attributes using Edit.

Editing attribute search settings

  1. Click the Edit button in the attribute's row. The dialog titled "Attribute search setting: <attribute name>" opens.
  2. The Attribute field is informational only.
  3. If needed, check or uncheck the Searchable box and edit other fields.
  4. Click Save.

If saving is successful, a "Attribute setting saved." notification appears and the list refreshes.

Notes:

  • If you uncheck Searchable and save, the attribute is removed from search and no longer appears in this list. To add it again, use Add attribute.
  • If the saved priority is empty or 0, the edit dialog opens with priority 5; saving writes 5. If the saved boost is undefined, the dialog opens with 0.
  • You must select a query type before saving an attribute without a saved query type.
  • Saving changes only these four search settings; other attribute settings remain. If current attribute settings cannot be read, saving is blocked and an error notification appears to avoid overwriting.
  • Attribute settings are not company-specific; changes write to the same attribute record regardless of the selected company in the header.

Fields in the dialog

Field Required Description / rule
Attribute Yes (when adding) Selected from the list when adding; if not selected, shows "Select an attribute" warning. If attribute list cannot be read, a red error message appears instead of the selection box. Cannot be changed when editing.
Searchable — Only visible in the edit dialog. Added attributes are always searchable.
Boosts Yes Weight multiplier of the attribute in search results; higher values are more effective. Integer 0 or greater; otherwise "Enter an integer of at least 0."
Priority Yes Integer between 1 and 10; otherwise "Enter an integer between 1 and 10."
Query type Yes must (mandatory), filter (filter), or should (prefer). If not selected, shows "Select a query type" warning.

If any warnings are present, the save button remains inactive. Pressing Enter in a numeric field saves. Closing the dialog with Cancel does not save changes.

Common situations

  • "Search management is not configured for this setup" appears. Search management is not set up for your workspace; settings on this screen are unavailable. Contact your system administrator.
  • "Something went wrong" appears instead of tabs. Settings could not be read. Click Retry; if the problem persists, report to your system administrator with the Technical detail text.
  • "Catalog settings could not be read" appears in the General settings tab. The selected company's store settings could not be accessed; the text below explains the reason. Click Reload or select another company. In this case, the Attribute settings tab continues to work.
  • "No company with web integration found" appears instead of the company box. Your account has no companies defined with website integration; company selection is not possible.
  • "No searchable attributes" appears in the Attribute settings tab. No attributes have been made searchable yet. Use Add attribute to make an attribute searchable.
  • "Attributes could not be read" appears. The attribute list could not be accessed; the text below explains the reason. Click Reload; if the problem persists, report to your system administrator. In this case, the General settings tab continues to work.
  • Save button is not clickable. There is an invalid value in a field; correct the field showing a red warning.

Related screens