- App Search Guide: other versions:
- Installation
- Getting started
- Authentication
- Limits
- Users and access
- Guides
- Adaptive relevance events logs reference
- Analytics Tags
- Crawl web content
- Crawl a private network using a web crawler on Elastic Cloud
- Crawl custom fields using proxy
- Curations
- Elasticsearch search
- Elasticsearch index engines
- Create Elasticsearch index engines
- Configure dynamic field mappings and analyzers in an Elasticsearch index engine
- Elasticsearch engines text field conventions
- Facets
- Hierarchical Facets
- Indexing Documents
- Language Optimization
- Log settings
- Meta Engines
- Precision tuning (beta)
- Query Suggestions
- Search UI
- Relevance Tuning
- Result Settings
- Result Suggestions
- Role based access control (RBAC)
- Sanitization, Raw or Snippet
- Search
- Synonyms
- View web crawler events logs
- App Search web crawler
- Web crawler FAQ
- Web crawler reference
- Web crawler events logs reference
- API Reference
- Adaptive relevance API reference (beta)
- Analytics APIs
- Analytics clicks API
- Analytics counts API
- Analytics queries API
- API logs API
- Click API
- Credentials API
- Curations API reference
- Documents API
- Elasticsearch search API
- Engines API
- Log settings API
- Multi search API
- Query suggestion API
- Schema API
- Search API
- Search API boosts
- Search API facets
- Search API filters
- Search API group
- Search API precision (beta)
- Search API result fields
- Search API search fields
- Search API sort
- Search API analytics tags
- Search settings API
- Search Explain API
- Source engines API
- Synonyms API
- Web crawler API reference
- API Clients
- Configuration
- Known issues
- Troubleshooting
Synonyms Guide
editSynonyms Guide
editSynonyms relate queries together that contextually have the same meaning in your dataset.
Sometimes users will use different terminology than your context might expect.
This can lead them to poor search relevance: you are selling movies, but they want films!
The Synonym feature builds synonym sets. A synonym set contains two or more queries that have similar meaning.
The queries can be synonyms, but they do not need to be.
Each item within a synonym set is a query. A query can be a string made up of one or more words.
Once a synonym set has been created, it will be applied to all future queries.
You can create them via the API or the Dashboard.
A synonym set can contain up to 32 words.
Precision tuning has no effect in queries that contain synonyms.
API
editYou may construct, list, or delete synonym sets using the /synonyms
API endpoint.
Example
curl -X POST '<ENTERPRISE_SEARCH_BASE_URL>/api/as/v1/engines/national-parks-demo/synonyms' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer private-xxxxxxxxxxxxxxxxxxxx' \ -d '{ "synonyms": ["summit", "peak", "cliff", "mountain"] }'
Example Response
{ "id": "syn-33dh34689rre8994g5h94i0nf4", "synonyms": [ "summit", "peak", "cliff", "mountain" ] }
Each synonym has a unique id
which you can use to display or delete the synonym set after it has been created.
See the Synonyms API Reference for further information.
Dashboard
editTo manage synonyms through the App Search dashboard, see the following video walkthrough:
Or, review the following instructions:
Within the dashboard, click into an Engine.
The Engine navigation menu has Search Settings section.
Under it you will find Synonyms alongside Curations and Relevance Tuning. Click into Synonyms.
Next, select Create a Synonym Set and then enter an assortment of queries.
Synonyms - A synonym set within the dashboard.
Once you click Save, the synonym set will be applied.
To remove the synonym set, click Manage, then Delete.
The moment it is deleted, the set will no longer influence your search results.
What’s Next?
editConfiguring Synonyms is a useful way to guide your users to the most relevant content. It is most useful when you know the precise terms that they are searching for. For that, you should explore the Analytics and Clickthrough end-points, so that you are aware of your insightful capabilities. If you are looking to provide even more precise and curated results, venture to the Curations end-point.
On this page