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.

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

The following General settings are available for configuration:

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

Type of the settings to be shown:
General settings
Analytics
All

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

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

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

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

Default synonym relationship - Default relationship if none is provided:
Synonym
Generic term
Very similar
Similar
Related
Default: Synonym

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

The following Analytics settings are available for configuration:
Synonym analytics generation active - Enables generating synonyms from analytics data. Default: false

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

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

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

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%

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

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

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:
Enable GPT synonyms.
Navigate to Cockpit.
Search for a search term for which GPT synonyms to be generated.
Click “Generate GPT Synonyms” icon:

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

Click the checkmarks in the Approval column (in this case the color of an item changes to green) to select required synonyms.
Select Relationship to the search word.
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.
GPT Synonyms List
GPT Synonyms list is an individual tab at GPT Synonyms page.

All created GPT-synonyms entries are listed in the grid together with their attributes.
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

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

Approval - shows synonym approval status:
approved are used as synonyms
unapproved should be kept in the list to avoid repeated generation

Relationship - Relationship to the query:
Synonym
Generic term
Very similar
Similar
Related

Created - Synonym creation date and time

Source - Origin of the synonym:
manual
on demand generation (at the cockpit)
analytics

Filter by:
source
approval status
Additionally the grid allows to filter entries:
hide/show entries deleted in this transaction
search for a specific entry
The following operations are available for GPT synonyms in the grid:
edit
clone to another channel
delete
bulk clone and delete operations are available for multiple selected (by
) entries
Note: Any creation or change to an entry will mark it as locked and require saving the transaction.
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.
Last updated
Was this helpful?