Ajuste de Relevancia

The Relevance page at /[orgSlug]/relevance lets you fine-tune how the AACsearch Engine ranks and filters results for your indexes. It is organized into three tabs: Synonyms, Curations, and Stopwords.

Each tab requires a selected index slug. If no index is selected, the page shows a prompt to choose one.

---

Synonyms

Synonyms let you define equivalences between search terms. When a user searches for a synonym root, documents matching any of its synonym words are returned.

How synonyms work

A synonym maps one or more variant terms to a root term:

"jeans" → "pants" "trainers" → "sneakers" "mobile" → "phone" (if locale = en)

When a query contains a synonym root, AACsearch expands the query to also match documents that contain the synonym variants. This is implemented via AACSearch synonym collections.

Managing synonyms

From the Synonyms tab you can:

• Add a synonym — enter the root term and one or more synonym variants (comma-separated)
• Edit a synonym — modify the root or variants inline
• Delete a synonym — remove the mapping; existing indexed documents are unaffected, but future queries will stop expanding

Synonyms are stored in a dedicated search index per index and served through the search.synonyms oRPC procedures.

Example

Feature availability

The Synonyms feature is available on Starter plans and above. It is gated behind the synonyms feature flag in the entitlements system.

---

Curations

Curations let you pin or hide specific documents for a given search query. This is useful for:

• Promoting a specific product to the top of search results for a branded query
• Hiding discontinued or out-of-stock items from certain search terms
• Merchandising seasonal products for relevant queries

How curations work

Each curation rule applies to a single query string and specifies:

• Pinned document IDs — documents that should appear at the top of results (in order)
• Hidden document IDs — documents that should be excluded from results

Rule: query = "summer sale" → Pin: ["tshirt-123", "shorts-456"] → Hide: ["winter-coat-789"]

When a user searches for "summer sale", the two pinned products will appear first, and the winter coat will be filtered out.

Managing curations

From the Curations tab you can:

• Add a curation — enter a query, then add pinned document IDs (imported products) and/or hidden document IDs
• Edit a curation — modify the pinned/hidden document lists
• Delete a curation — remove the rule; subsequent searches for that query will return default ranking

Document IDs

Pinned and hidden IDs must correspond to the id field of documents that exist in your search index. IDs are case-sensitive and must match exactly.

---

Stopwords

Stopwords are common words that are excluded from the search index. They reduce noise in search results and improve performance by skipping words that carry little meaning.

Default stopwords

AACsearch comes with a built-in set of stopwords per locale. For English, these include words like:

a, an, the, is, it, in, on, at, for, to, of, and, or, but, with, without

Managing stopwords

From the Stopwords tab you can:

• View the current stopwords list for a selected index
• Add stopwords — enter one or more words (comma-separated)
• Remove stopwords — delete a word from the list

Changes to stopwords are applied via a reindex — existing documents already in the search index are not automatically re-processed. After changing stopwords, trigger a reindex for the changes to take full effect.

---

API access

All three relevance features are available through oRPC procedures at packages/api/modules/search/procedures/:

All procedures require the caller's organization ID and index slug as input.

Related pages

• Search Workspace
• Analytics Dashboard
• Plans & Limits