Merchandising settings
Use the Settings workspace to configure search and product discovery for your storefront. The following tabs are available:
- Facets—Configure price range groups and intervals used as search filters.
- Language—Set the catalog language used for indexing and search.
- Advanced search—Enable semantic search and fuzzy search, and tune semantic boost and similarity thresholds.
Access the Settings workspace
How you open the Settings workspace depends on the product you use:
- Adobe Commerce Admin (Adobe Commerce as a Cloud Service)—Select Merchandising > Merchandising Settings.
- Adobe Commerce Optimizer Studio—Select Merchandising > Settings.
Price facets price-facets
You can specify the number of price range groups and how price values are distributed among them. Each price range overlaps the previous group by one. For example, five groups with an interval of 20 create price ranges: 0-20, 20-40, 40-60, 60-80, and >80. If there are not enough products in the catalog to fill all defined ranges, the display of the available groups is adjusted accordingly. For example: 0-20, 60-80, >80.
To configure price facets:
-
From the Settings workspace, select Facets.
-
In the Price facet section, do the following:
- Enter the Number of selections, or price groupings to be available. Up to 100 price groupings can be defined.
- Enter the Interval value, or price range for each group. The maximum value is 40,000,000.
-
Click Save.
It takes about 15 minutes for the updated settings to be available in the storefront.
Price facet field descriptions
| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Field | Description |
| Number of selections | Specifies the number of price range groupings that can be used as search filters in the storefront. Default value: 8, Maximum value: 100 |
| Interval value | Specifies the price range interval for each group. For example, five selections with an interval value of 20 yield groupings of 0-20, 20-40, 40-60, 60-80, and >80. Default value: 5, Maximum value: 40,000,000 |
Language language
The Language setting tells the system which language to expect when reading the catalog and writing the index.
Languages have different sets of rules for grammar: how words are separated, verb tenses and word forms, for example.
The Language setting ensures that the correct set of rules is applied to the indexing mechanism.
Set the Language setting to the primary language of the catalog. Changing the index language takes 5 to 60 minutes to appear on the storefront, depending on catalog size and complexity.
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 15-row-2 16-row-2 17-row-2 18-row-2 19-row-2 20-row-2 21-row-2 22-row-2 23-row-2 24-row-2 25-row-2 26-row-2 27-row-2 28-row-2 29-row-2 30-row-2 31-row-2 32-row-2 33-row-2 34-row-2 35-row-2 36-row-2 37-row-2 38-row-2 | |
|---|---|
| Language | Code |
| Arabic | ar |
| Armenian | hy |
| Basque | eu |
| Bengali | bn |
| Brazilian | pt-br |
| Bulgarian | bg |
| Catalan | ca |
| Chinese (Simplified) | zh-cn |
| Chinese (Traditional) | zh-tw |
| Czech | cs |
| Danish | da |
| Dutch | nl |
| English | en |
| Estonian | et |
| Finnish | fi |
| French | fr |
| Galician | gl |
| German | de |
| Greek | el |
| Hindi | hi |
| Hungarian | hu |
| Indonesian | id |
| Irish | ga |
| Italian | it |
| Japanese (Katakana) | ja |
| Korean | ko |
| Latvian | lv |
| Lithuanian | lt |
| Norwegian | no |
| Persian | fa |
| Portuguese | pt |
| Romanian | ro |
| Russian | ru |
| Sorani | ku |
| Spanish | es |
| Swedish | sv |
| Turkish | tr |
| Thai | th |
Advanced search advanced-search
Use the Advanced search tab to manage search in one place. The system delivers a unified search experience on the storefront; you do not configure keyword search and semantic search separately for shoppers. Enable semantic search is enabled by default for eligible English catalogs. Semantic search works alongside your existing configuration; merchandising rules, synonyms, facets, boosts, and filters continue to apply. The system uses predefined catalog attributes automatically—you do not select or prioritize attributes in Settings. No storefront or developer changes are required.
To manage semantic search:
-
On the Settings workspace, select the Advanced search tab.
-
Under Enable semantic search, confirm semantic search is enabled, or disable it if you do not want semantic matching.
-
Click Save if you change the toggle or tuning controls.
Search results update after indexing completes. For a medium-sized catalog, indexing can take up to 30 minutes. For large catalogs with millions of products, it can take a few hours.
Optional tuning
After semantic search is enabled, you can adjust the following on the same tab:
- Semantic boost—To prioritize semantically relevant results in ranking, apply a boost. Raise the value when semantic matches should weigh more heavily in the result set; lower it when results feel too broad.
- Similarity threshold—Set the minimum similarity score (as a percentage) for a semantic match. Lower values return more results (higher recall) but may include weaker matches. Higher values return fewer, tighter matches (higher precision).
- Fuzzy search—To find near matches for search queries and correct typos and minor variations, turn on.
- Fuzzy search similarity threshold—Set the minimum similarity (as a percentage) required for fuzzy matches to appear. Lower thresholds return more approximate matches; raise the threshold if fuzzy results feel too broad.
| note |
|---|
| NOTE |
| Semantic search is supported for English catalogs only. Selecting another language on the Language tab disables Enable semantic search. |
For benefits, validation guidance, best practices, troubleshooting, and limitations, see Semantic search.
Advanced search field descriptions
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 | |
|---|---|
| Control | Description |
| Enable semantic search | When enabled, search uses meaning and context alongside keyword matching. Predefined catalog attributes are used automatically; no attribute setup is required in Settings. Enabled by default. |
| Semantic boost | Boost applied to prioritize semantically relevant results in ranking. |
| Similarity threshold | Minimum similarity score (percentage) for a semantic match. Lower values favor recall; higher values favor precision. |
| Fuzzy search | When on, search finds near matches for queries (for example, minor variations). |
| Fuzzy search similarity threshold | Minimum similarity (percentage) fuzzy matches must meet to appear in results. |