After July 2021, the 2.3.x release line will no longer receive quality updates, or user guide updates. PHP 7.3 reaches end of support in December 2021 and Adobe Commerce 2.3.x reaches end of support in September 2022. We strongly recommend planning your upgrade now to Adobe Commerce 2.4.x to help maintain PCI compliance.

Search Synonyms

The information on this page is intended for Adobe Commerce 2.3 customers who are on an extended support contract. The Adobe Commerce Merchant Documentation for current releases is published on the Adobe Experience League.

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, while your product is listed as a couch. Or perhaps they spelled it wrong, or just differently. Is it a sweatshirt, or a sweat shirt? Maybe it is a fleece or a hoodie. You can capture a broad range of search terms by entering all the possible words a customer might use to find your products.

Example storefront - search results with synonyms Search Results

Create a New Synonym Group

  1. On the Admin sidebar, go to Marketing > SEO & Search > Search Synonyms.

    The Search Synonyms grid appears. If this is the first time you have used search synonyms, the grid will be empty.

    Search synonyms grid Search Synonyms Grid

  2. Click New Synonym Group and do the following:

    New search synonyms group New Synonym Group

    • 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.

  3. When complete, click Save Synonym Group.

    Search synonyms group grid - saved group Search Synonym Group Saved