SuggestAPISuggestAPIDocumentation
Contact usOpen app
Console

Search Index Settings

Configure searchable fields, boosts, synonyms, search mode, and reindex from the Configuration tab.

Copy page
Open in ChatGPTOpen with page contextOpen in ClaudeOpen with page context

Open the index, then Configuration. These controls change how autocomplete ranks and expands queries for this index when search is SuggestAPI hosted. They are not applied in search proxy mode. Save configuration before you reindex.

If the index is the account primary-domain index, the linked hostname appears here as read-only. Change domain linkage on Agent content.

You cannot save configuration (including merchandising) while an import or reindex is running. Finish or cancel it on Tasks.

Field configuration

After documents exist, SuggestAPI lists fields found on a sample record (standard fields plus keys under raw).

For each field you add:

  • Searchable — include the field in lexical retrieval.
  • Boost weight — 0–10, default 1.0. Higher values increase that field’s influence on ranking.

Add unconfigured fields with + fieldname. Remove drops a field from the schema; it does not delete document data.

Primary key and ID variants (id, objectID, _id, and similar) stay out of this list.

Save Configuration writes the schema. Tune fields after a representative import, not on an empty index.

Synonyms

Synonyms are query-expansion mappings. When a shopper searches for the term, SuggestAPI also searches the listed synonyms.

  1. Enter a term (stored lowercase).
  2. Enter synonyms, comma or newline separated.
  3. Add Synonym Mapping, then Save Configuration.

Use this for brand abbreviations, common misspellings you want to treat as equivalent, and catalog jargon. Spell correction still runs separately on the search path.

Search mode

Mode Behavior
Hybrid (FTS + Vector) Default. Combines full-text search and vector similarity.
FTS Only Lexical retrieval only.
Vector Only Semantic retrieval only.
FTS with Vector Rerank Lexical candidates, then vector rerank.

Pick Hybrid unless you are diagnosing lexical vs semantic issues. Save, then test.

Capability background: Search capabilities.

Reindex

Reindex Documents regenerates embeddings and search text for every existing document using the saved schema. It does not upload a new file.

Save unsaved field, synonym, or mode changes first. The console prompts Save and Reindex if you have a dirty schema. Reindex is disabled while another background task is running.

Track the job on Tasks. After it completes, confirm ranking on Test Search.

Search rules

Exact-query pins live on this same tab as Search rules (Paid). See Merchandising.