# GPT Synonyms

## Summary

**GPT synonyms** is available starting with version NG 3.1.464.

**GPT synonyms** enhances search flexibility by automatically suggesting alternative terms with similar meanings. This helps users find relevant products even when they use different phrasing, slang, or regional variations—improving accuracy and reducing "no results" scenarios.

You can find **GPT synonyms** in the left-hand menu under **More settings…** within the **Modules** section.

![](/files/slQerslCHV2x3VrsY4Bx)

## GPT Synonyms Settings

The **GPT Synonyms settings** tab appears on the GPT Synonyms page.

The most important control on this page is the **GPT Synonyms active** switch, which enables or disables generation and application.

There are two types of settings to configure:

* General settings
* Analytics

### General Settings

![](/files/DQDi8fljzprhn3vK1MN3)

The following **General settings** are available for configuration:

![](/files/Ph63z0daepEWYQihI5Tp)

**GPT Synonyms active** - Defines if GPT Synonyms are enabled. *Default: false*

![](/files/Ehk1tMw4qBIWvCgJj7rh)

**Type of the settings to be shown:**

* General settings
* Analytics
* All

![](/files/UipZ5ADW4CYdVObCmdDS)

**Contexts to search synonyms in** - List contexts where the channel is used. Used to generate better synonyms.

![](/files/2XF0kf1Bm7Z35I6UtFNL)

**Maximum synonyms per request** - How many synonyms to generate per request. *Max: 10, Default: 10*

![](/files/cVfuaDKK4FYgURysSN7J)

**Maximum number of words per query** - Maximum number of words in a query used for synonym generation. *Default: 2*

![](/files/dOZlcoZrhcFshT4JyY3F)

**Expiration duration of synonyms** - Lifetime of pending synonyms in days. `-1` means unlimited, `0` means they won’t be saved. *Default: -1*

![](/files/afMFqoHYxlD3P4x4s54e)

**Default synonym relationship** - Default relationship if none is provided:

* Synonym
* Generic term
* Very similar
* Similar
* Related

*Default: Synonym*

![](/files/heY1jGf0d6KIgQt5tmq5)

**Apply pending synonyms** - Whether unapproved (pending) synonyms should be used during search. *Default: true*

### Analytics

![](/files/1yo7I9tuaVP84MsNX5BJ)

The following **Analytics** settings are available for configuration:

![](/files/Ph63z0daepEWYQihI5Tp) **Synonym analytics generation active** - Enables generating synonyms from analytics data. *Default: false*

![](/files/Ehk1tMw4qBIWvCgJj7rh)

**Minimum number of searches for generation via analytics** - Minimum searches for a query before it is considered for analytics-based generation. *Default: 5*

![](/files/UipZ5ADW4CYdVObCmdDS)

**Maximum number of products for generation via analytics** - Maximum number of hits a search may have to be considered for analytics-based generation. This, the click-to-checkout ratio, or the click-through ratio must match. *Default: 10*

![](/files/2XF0kf1Bm7Z35I6UtFNL)

**Ratio of click to checkout events for analytics generation** - Minimum click-to-checkout ratio for a search to be considered. This, the click-through ratio, or the result count must match. *Default: 100:1*

![](/files/cVfuaDKK4FYgURysSN7J)

**Ratio of searches to click events for analytics generation** - Maximum searches-to-clicks ratio for a term to be considered. This, the click-to-checkout ratio, or the result count must match. *Default: 10%*

![](/files/dOZlcoZrhcFshT4JyY3F)

**Size of score drop in bad search results** - Threshold for a score drop on page one that marks a result as "bad." Used to evaluate synonym influence. *Default: 10*

![](/files/afMFqoHYxlD3P4x4s54e)

**Excluded source words** - List of search terms for which no synonyms will be generated

![](/files/heY1jGf0d6KIgQt5tmq5)

**Allowed filters** - Names of filters that may be present in analytics-sourced search requests and still allow consideration for generation.

## GPT Synonyms Generation

To **generate GPT Synonyms** the following should be done:

1. Enable GPT synonyms.
2. Navigate to [Cockpit](/docs/discovery/cockpit.md).
3. Search for a search term for which GPT synonyms to be generated.
4. Click “Generate GPT Synonyms” icon:

![](/files/EpMK9wjNMWuUzbniXIl9)

5. After clicking this button/icon, a window with synonyms of the current search term will appear:

![](/files/Brao6m4677e1kQFQguBj)

6. Click the checkmarks in the **Approval** column (in this case the color of an item changes to green) to select required synonyms.
7. Select **Relationship** to the search word.
8. Click **APPLY AND CLOSE** to add both approved and unapproved synonyms to the current transaction. Unapproved synonyms are stored to prevent repeat suggestions in Cockpit.
9. [Save the transaction](/docs/user-interface/editing-configurations-managing-transactions.md)

## GPT Synonyms List

**GPT Synonyms** **list** is an individual tab at GPT Synonyms page.

![](/files/dNp0ZNIizW1hHjicQX98)

All created GPT-synonyms entries are listed in the grid together with their attributes.

![](/files/Ph63z0daepEWYQihI5Tp) **Query** - Lists all queries for which GPT synonyms has been created. Allows to:

* select a query to list all it’s synonyms
* add new query to manually add synonyms for it

![](/files/Ehk1tMw4qBIWvCgJj7rh)

**Manually add GPT Synonyms -** type in a synonym, select approval and relationship, click “plus” button to add

![](/files/UipZ5ADW4CYdVObCmdDS)

**Approval -** shows synonym approval status:

* approved are used as synonyms
* unapproved should be kept in the list to avoid repeated generation

![](/files/2XF0kf1Bm7Z35I6UtFNL)

**Relationship** - Relationship to the query:

* Synonym
* Generic term
* Very similar
* Similar
* Related

![](/files/cVfuaDKK4FYgURysSN7J)

**Created** - Synonym creation date and time

![](/files/dOZlcoZrhcFshT4JyY3F)

**Source** - Origin of the synonym:

* manual
* on demand generation (at the cockpit)
* analytics

![](/files/afMFqoHYxlD3P4x4s54e)

**Filter by**:

* source
* approval status

Additionally the grid allows to **filter** entries:

* hide/show entries deleted in this transaction ![](/files/Sqx7q5UTXXhUawSHwnqh)
* search for a specific entry ![](/files/TA2cmO6o32bttrwoI2Mj)

The following **operations** are available for GPT synonyms in the grid:

* edit ![](/files/tTcq74SDxHc1TbcCPhkS)
* clone to another channel ![](/files/BE54BC6URRrdtVW1CXtk)
* delete ![](/files/vLFbeBNtr8ONFAVVFUOV)
* bulk clone and delete operations are available for multiple selected (by ![](/files/p8k00RPckDSQPHooq4Gh)) entries

**Note:** Any creation or change to an entry will mark it as locked ![](/files/g0DM13QsLjGG1HqSA542) and require [saving the transaction](/docs/user-interface/editing-configurations-managing-transactions.md).

## GPT Synonyms Jobs

**GPT Synonyms** **jobs** is an individual tab at GPT Synonyms page.

Currently these jobs cannot be enabled. But they are part of a future version of the GPT synonyms feature.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.fact-finder.com/docs/modules/gpt-synonyms.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.