Synonym Detection

The Synonym Detection feature generates pairs of synonyms and pairs of similar queries. Two words are considered potential synonyms when they are used in a similar context in similar queries. When synonym detection is enabled, a query that contains a matching term is expanded to include all of its synonyms, with the original term boosted by a factor of two.

Synonyms are applied in the Text Tagger stage of the query pipeline.

The Synonym and Similar Queries Detection job automatically creates synonyms based on your AI-generated data. When you navigate to Relevance > Query Rewriting > Synonym Detection, you can review or edit the output from the job and manually add new synonyms. Your changes remain in the _query_rewrite_staging collection until you publish them.

Tip
When you manually add new synonyms, subsequent job runs use those documents as input for machine learning to improve the job’s output. Unlike job-generated documents, manually-added query rewriting documents are never overwritten by new job output.
Tip
When a query contains a known synonym, the original term is expanded to include all of its synonyms. To completely replace a term instead, see the Misspelling Detection feature.

Synonyms screen

Uni-directional and bi-directional synonyms

When you edit or create a synonym, you can configure its directionality, either uni-directional or bi-directional.

The default is uni-directional. In the uni-directional example below, "iphone" is a synonym of "phone" but "phone" is not a synonym of "iphone":

Uni-directional synonyms

Click the arrow to change it to bi-directional. In the bi-directional example below, "tv" is a synonym of "television" and "television" is a synonym of "tv":

Bi-directional synonyms

Reviewing auto-generated synonyms

Synonyms that are automatically generated by the Synonym and Similar Queries Detection job are assigned one of these Status values:

  • Auto

    These results have a sufficiently high confidence level to automatically deploy them to the _query_rewrite collection.

    No action is required on these results, though you can edit them if you wish.

  • Pending

    The confidence level is ambiguous, and the result must be reviewed by a user before it can be deployed. It will only be moved from the query_rewrite_staging collection to the _query_rewrite collection when its status has changed to "Approved" _and it has been published.

    See below for instructions.

How to review a pending synonym result
  1. Navigate to Relevance > Query Rewriting > Synonym Detection.

    Tip
    Notice the Status facet on the left. Click Pending to view only the items that need review.
  1. Click the Edit icon icon next to the synonym.

    Tip
    In addition to approving or denying a pending item, you can also edit the synonyms. Although the Confidence field is also editable, changing its value makes no difference.
  1. In the Status column, select either "Approved" or "Denied".

  2. Click the Close icon next to the updated synonym:

    Close a synonym

Note
Approving a synonym does not automatically deploy it to the _query_rewrite collection. When you have finished your review, you must click Publish to deploy your changes.

Adding new synonyms

In addition to the synonyms generated by the Synonym and Similar Queries Detection job, you can manually add your own.

How to add a synonym
  1. Navigate to Relevance > Query Rewriting > Synonym Detection.

  2. At the bottom of the rules list, click the Add icon icon.

    A new synonym appears at the top of the list:

    Add a synonym

  3. Enter the query term.

  4. Enter one or more synonyms.

    Tip
    It’s not necessary to set a confidence value.
  5. Select the synonym’s status, depending on whether you want to deploy it the next time you publish your changes ("Approved") or save it for further review ("Pending").

  6. Click the check mark to save the new synonym:

    Save a synonym

Publishing your changes

How to publish updated synonyms
  1. In the Synonym Detection screen, click the PUBLISH button.

    Fusion prompts you to confirm that you want to publish your changes.

  2. Click PUBLISH.

Tip
You can un-publish a query rewrite by changing its status to "pending" or "denied", then clicking PUBLISH.