Setting up Live Search
The workspace is where you configure, manage, and monitor the performance of Live Search. The menu across the top provides access to the tools in each functional area. The available features reflect the current menu selection.
Data collection
To ensure that each functional area on the workspace contains the correct data, you need to configure data collection based on the selected storefront implementation:
- Luma - Data collection is available out-of-the-box.
- Headless - Data collection must be configured manually, depending on storefront implementation.
If you are using a headless storefront, refer to the following documentation to get more information about the required events that you need to add:
- Required events for Live Search dashboard.
- Storefront events collector that needs to be added as a prerequisite.
- Examples of the events structure.
Set the scope
Initially the scope of all Live Search settings is set to Default Store View
. If your Commerce installation includes multiple store views, set Scope to the store view where your facet settings apply.
Menu Options
Set attributes as searchable
To produce highly-targeted results, review the set of searchable (searchable=true
) product attributes. To ensure relevancy, make attributes searchable only if they contain content that has a clear and concise meaning. Avoid using attributes that contain less precise, lengthy text such as description
, which although search-enabled by default, can reduce the precision of search results. For example, if a person searches for “shorts” and there are shirts with a description that includes the term “short sleeves”, then the shirts will be included in the search results.
To allow attributes to be searchable, complete the following steps:
-
In the Admin, go to Stores > Attribute > Product.
-
Select the attribute you want to be searchable, such as
color
. -
Select Storefront Properties and set Use in Search to
yes
.
Live Search also respects the weight of a product attribute, as set within Adobe Commerce. Attributes with a higher weight will appear higher within the search results.
The following attributes are always searchable:
sku
name
categories
Facets are product attributes that are defined in Live Search to be filterable. You can set any filterable attribute as a facet in Live Search, but there are limits to how many facets you can search for at one time.
Synonyms are terms that you can define to help guide users to the correct product. Users looking for pants might type in “trousers” or “slacks”. You can set synonyms so that these search terms will get users to the “pants” results.
Commerce Configuration Settings
The following section describes the supported and unsupported Commerce configuration settings for Live Search.
Supported configuration values
Yes
, includes the ALL
option in the “Show per Page” control.Prices in the Widget Product Listing Page and Popover are converted to the Default Display Currency using the configured Currency Rates.
Unsupported configuration values
Search terms
Live Search supports search term redirects on implementations where Adobe Commerce handles the routing, such as on Luma and other php-based themes.