---
updatedAt: 2026-02-19T08:10:15.000Z
agentTools:
  projectIndex: https://docs.perselio.com/llms.txt
---

# Search Curation

While the search is designed to deliver highly relevant results by default, sometimes you’ll want more control. For example, you may want to boost specific products to the top of the results, or exclude certain items entirely from appearing. This flexibility ensures your customers always see the results that best match your business goals.

Search results can be manually moderated.

When to use synonyms or override?

* Use synonyms when expanding lexical equivalence (recall) at query time, both terms can coexist and are present in the catalogue.
* Use override when you don't want to search for the original query and rewrite/replace it. It's good for intent steering.

<br />

# Synonyms

The synonyms feature lets you define different search terms that should be treated as equivalent.
For example, if you set sneaker as a synonym of shoe, a search for sneaker will return results containing both sneaker and shoe.

We support two kinds of synonym mappings:

## One-way synonyms

If you define `iphone` and `android` as synonyms of `smart phone`, then a search for `smart phone` will also return results containing `iphone` or `android`. However, searching for `iphone` will not return `smart phone` unless explicitly configured.

## Multi-way synonyms

If you create a set with `blazer`, `coat`, and `jacket`, a search for any of these terms (e.g., `coat`) will return results containing any of the words in the group (`blazer`, `coat`, or `jacket`).

<br />

# Override rules

* Triggering of the rule is based on the token in the query
* Match mode - `exact` or `contains`
* Set time duration when applicable (`time-from` and `time-to`)
* Rules are handled first before synonyms

<br />

## Replace query

Example

> query `Nike` overwrite to `Puma`

## Pin products

Include specific products in positions.

Example

> when query contains `nike`, pin product (id:XY) at position 2 and product (id:XZ) at position 5

## Exclude products

Excluding specific products.

Example

> when query contains `klimatex`, exclude product (id:XY)

## Remove specific tokens

Remove specific tokens from the query.
Example

> when query contains `xiaomi` phone, exclude `xiaomi` from query

<br />

# Boosting

<i class="fa-duotone fa-solid fa-paper-plane" /> Coming soon

***

<br />

<i class="fa-regular fa-bell" /> Currently, synonyms and override rules are handled by the team. Self-service management is <i class="fa-duotone fa-solid fa-paper-plane" /> coming soon in [Console](https://docs.perselio.com/docs/console).