Use Query Rewrites in the Rules Editor

This article describes how to use the Rewrites screen in the Rules Editor.

Query rewrite rule types

  • Head/Tail - Replace underperforming queries with queries that produce higher click-through rates. Query improvements always require review before they are published. Schedule the Head/Tail Analysis job to get AI-generated query improvements based on your signals collection. See Underperforming Query Rewriting.

  • Misspelling - Fusion replaces misspelled query terms with their spelling corrections for better search results. Schedule the Token and Phrase Spell Correction job to get AI-generated spelling corrections based on your signals collection. See Misspelling Detection.

  • Phrase - Known phrases are boosted when they appear in new queries. Schedule the Phrase Extraction job to get AI-generated phrases based on your signals collection. See Phrase Detection.

  • Synonym - Synonyms are used to expand queries so that they include all known synonyms of the query terms. Schedule the Synonym and Similar Queries Detection job to get AI-generated synonyms based on your signals collection. See Synonym Detection.

Enable/Disable

You can quickly enable or disable query rewrite rules by clicking the green or red circle next to the panel title and choosing Enabled or Disabled from the dropdown menu that appears. Choosing Disabled prevents all query rewrite rules of that rule type from being applied to searches.

Status dropdown

Facets

Facet menu

Use facets in the Query Rewrite screen

To facet the rules list by Status or Published, click one of the facet items within the facet categories.

To facet the rules by Confidence, click and drag either slider to set the range of confidence you’d like to see:

Confidence facet

Note
Faceting rules by confidence is not available for Head/Tail rewrites.

Enter a search term to quickly facet your query rewrite rules:

Search query rewrite

Rules

Begin by selecting one of the query rewrite rule types you will create.

Query rewrite rule types

Create a rule

  1. Click the Add button large button in the top-right corner of the card. Alternatively, click the Add button small button in the bottom-left corner of the card. A new row is inserted in the rules table below.

  2. Complete the required fields, at a minimum.

  3. Once complete, click the Add button check button. Click the Cancel add button button to cancel.

Edit a rule

  1. Hover over a rule. A row of buttons will appear on the right.

  2. Click the Edit button button.

  3. Make your desired changes to the rule.

  4. Once complete, click the Add button check button. If no changes are made, clicking the Add button check button will not affect the rule.

Approve/deny rules

  1. Hover over a rule. A checkbox will appear on the left.

  2. Click the checkbox to select the rule.

  3. Repeat this process to select multiple rules. (optional)

  4. Click the {approve-button} button to approve the selected rules, or click the {deny-button} button to deny the rules.

Publish a rule

  1. Hover over a rule. A checkbox will appear on the left.

  2. Click the checkbox to select the rule.

  3. Repeat this process to select multiple rules. (optional)

  4. Click the Publish selected button button to publish the selected rules.

Publish an individual rule

  1. Hover over a rule. A row of buttons will appear on the right.

  2. Click the Publish individual button button. A confirmation box will appear.

  3. Click the Publish button button to confirm.

Delete rules

Delete a single rule

  1. Hover over a rule. A row of buttons will appear on the right.

  2. Click the Delete button small button. A confirmation box will appear.

  3. Click the Delete button large green button to confirm.

Delete multiple rules

  1. Hover over a rule. A checkbox will appear on the left.

  2. Click the checkbox to select the rule.

  3. Repeat this process to select multiple rules. (optional)

  4. Click the Delete button large red button to delete the selected rules. A confirmation box will appear.

  5. Click the Delete button large green button to confirm.

Sort rules

  1. Hover over column titles. A Arrow down icon icon will appear for some titles to indicate the rules list can be sorted by that column.

  2. Click on the title column to sort the rules.

Note
The column that is currently sorting the rules list is indicated by an Arrow down icon or Arrow up icon icon.

Export rules

To export the rules list, simply click the Export button button. This generates a .csv file containing your rules.

Columns

Customize columns

Customize columns in the Query Rewrites screen
  1. Hover over the row of column titles. A Config button button will appear on the right.

  2. Click the Config button button. The Customize Columns to Display dialog box will appear.

    Customize Columns to Display

  3. Click the checkboxes to select or deselect the columns you want to display.

  4. Click the Save button blue button to save your changes.