After July 2021, the 2.3.x release line no longer received quality updates or user guide updates. PHP 7.3 reached end of support in December 2021, and Adobe Commerce 2.3.x reached end of support in September 2022. We strongly recommend upgrading to Adobe Commerce 2.4.x to help maintain PCI compliance.

Search Synonyms

This site contains archived merchant documentation for a version of Adobe Commerce and Magento Open Source that has reached end-of-support. The documentation available here is intended for historical reference only and is not maintained. 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