Manage search terms
The landing page for a search term can be a content page, a category page, a product detail page, or even a page on a different site.
Use search terms to capture common misspellings and redirect them to the appropriate page. For example, if you sell wrought iron patio furniture, you know that many people misspell the term as rod iron, or even rot iron. You can enter each misspelled word as a search term, and make them synonyms for wrought iron. Even though the word is misspelled, the search is directed to the page for wrought iron.
You can also learn what your customers are looking for by examining the search terms they use to find products in your store. If enough people look for a product that is not in your catalog, it could indicate a sales opportunity. Meanwhile, rather than have them leave them empty handed, you can redirect them to another product in your catalog.
Add search terms
As you learn new words that people use to search in your store, you can add them to your search terms list to direct people to the most closely matching products in your catalog.
{width="700" modal="regular"}
Add a search term
-
On the Admin sidebar, go to Marketing > SEO & Search > Search Terms.
-
Click Add New Search Term.
{width="600" modal="regular"}
-
Under General Information in the Search Query box, enter the word or phrase that you want to add as a new search term.
-
If your store is available in multiple languages, choose the applicable Store view.
-
To redirect the search results to another page in your store, or to another website, enter the full URL of the target page in the Redirect URL field.
-
If you want this term to be available for use as a suggestion whenever a search returns no results, set Display in Suggested Terms to
Yes
. -
When complete, click Save Search.
Edit a search term
-
In the Search Terms grid, click the row of any record to open the search term in edit mode.
-
Make the necessary changes.
-
When complete, click Save Search.
Delete a search term
There are two methods for deleting a search term – from the grid and on the edit page.
Method 1: In the Search Terms grid
-
In the list, select the checkbox of the term to be deleted.
-
In the upper-left corner of the list, set Actions to
Delete
. -
When complete, click Submit.
Method 2: On the Edit a Search Term page
-
On the Admin sidebar, go to Marketing > SEO & Search > Search Terms.
-
Find the search term to be deleted and open it in edit mode.
-
Click Delete Search.
-
To confirm the action, click OK.
Popular search terms
The Search Terms link in the footer of your store displays the search terms used by visitors to your store, ranked by popularity. Search terms appear in a tag cloud format, where the size of the text indicates the popularity of the term.
By default, Popular Search Terms is enabled as a search engine optimization tool, but has no direct connection to the catalog search process. Because the Search Terms page is indexed by search engines, any terms on the page can help improve your search engine ranking and the visibility of your store. The URL of the Popular Search Terms page is: mystore.com/search/term/popular/
{width="600" modal="regular"}
To configure popular search terms:
-
On the Admin sidebar, go to Stores > Settings > Configuration.
-
In the left panel, expand Catalog and choose Catalog underneath.
-
Expand the Search Engine Optimization section.
{width="600" modal="regular"}
For a detailed list of these options, see Search Engine Optimization in the Configuration Reference.
-
Set Popular Search Terms as needed.
If needed, clear the Use system value checkbox to change this setting.
-
When complete, click Save Config.
Search synonyms
One way to improve the effectiveness of catalog search is to include different terms that people may use to describe the same item. You do not want to lose a sale just because someone is looking for a sofa, and your product is listed as a couch. You can capture a broader range of search terms by entering sofa, davenport, and loveseat as synonyms for couch, and direct them to the same landing page.
Adobe Commerce supports two different synonym management solutions:
- Live Search Synonyms feature is available for Adobe Commerce installations with Live Search installed.
- The standard Search Synonyms feature (described in this page) is available out-of-the-box for all Adobe Commerce installations.
name
and sku
product attributes only.{width="700" modal="regular"}
Create a synonym group
-
On the Admin sidebar, go to Marketing > SEO & Search > Search Synonyms.
The Search Synonyms grid appears. If it is the first time you have used search synonyms, the grid is empty.
{width="700" modal="regular"}
-
Click New Synonym Group.
{width="700" modal="regular"}
-
Set Scope to the store views where the synonyms apply.
-
Enter each synonym in the group, separated by comma. Choose words that people might use as search criteria. For example:
sweatshirt, sweat shirt, hoodie, fleece
cell phone, mobile phone, smart phone
couch, sofa, davenport
wrought iron, rot iron, rod iron
-
To merge these synonyms into a group with others that have the same scope, select the Merge existing synonyms checkbox.
-
When complete, click Save Synonym Group.
Edit a synonym group
-
In the Search Synonyms grid, click the row of any record to open the synonym group in edit mode.
-
Make the necessary changes.
-
When complete, click Save Synonym Group.
Delete a synonym group
There are two methods for deleting a synonym group—from the grid and on the edit page.
Method 1: In the Search Synonyms grid
-
In the Search Synonyms grid, select the checkbox of the group to be deleted.
-
In the upper-left corner of the list, set Actions to
Delete
. -
When complete, click Submit.
Method 2: On the Edit a Synonym Group page
-
In the Search Synonyms grid, click the row of any record to open the synonym group in edit mode.
-
Click Delete Synonym Group.
-
When prompted, confirm the removal of the group.
Search Terms report
The Search Terms report shows the number of results for each term, and the number of times (hits) the term was used. The report data can be filtered by term, store, results, and hits, and exported for further analysis.
View the report
-
On the Admin sidebar, go to Reports > Marketing > Search Terms.
-
Use the controls to filter the report as needed.
{width="700" modal="regular"}
Export the report
-
For Export to, choose an export format:
CSV
- A comma-separated value file containing plain text dataExcel XML
- An XML-based, spreadsheet data format
-
Click Export.
The generated file is automatically saved to your designated folder for downloads.