Looking for the old docs site? You can still view it for a limited time here.

Use Synonym Detection

Reviewing auto-generated synonym pairs

Synonyms that are automatically generated by the Synonym and Similar Queries Detection job are assigned the following Status value:

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

    By default, all results from synonym job are set to "Pending", since there are usually limited number of synonyms and synonym expansion can have high impact on relevancy. 

    See below for instructions.

How to review a pending synonym pair 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 pair.

  2. In the Status column, select either "Approved" or "Denied".

    Optionally, you can also edit the synonym pair itself.

    Where alternative synonyms were detected, you can click Suggestions to view and select them as replacements for the displayed synonym pair:

    Suggestions

    Tip
    Although the Confidence field is also editable, changing its value makes no difference.
  3. Click the Close icon next to the updated synonym pair:

    Close a synonym pair

Note
Approving a synonym pair 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 synonym pairs

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

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

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

    A new synonym pair appears at the top of the list:

    Add a synonym pair

  3. Enter the query term.

  4. Enter one or more synonym pairs.

    Tip
    It’s not necessary to set a confidence value.
  5. Select the synonym pair’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 pair:

    Save a synonym pair

Publishing your changes

How to publish updated synonym pairs
  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.