Synonyms allow you to define groups of equivalent words, expanding search coverage so users find content even when using different terminology.
Current release: 2.2.01
How Synonyms Work
Configured synonyms add a supplementary exact-term lookup alongside ordinary keyword matching. Searching for a group member can consider indexed occurrences of the other members, with reduced scoring. Candidate limits, score thresholds, filters, and searchable content still determine which posts appear.
This is an explicit vocabulary list, not automatic paraphrase recognition. Meaning reranking can reorder existing keyword candidates but does not guarantee retrieval of every equivalent question. AI answer writing is a separate choice.
Example:
If you define: car, automobile, vehicle
Then searching for "car" can consider eligible indexed posts with:
- "automobile"
- "vehicle"
- "car"
Configuration
Adding Synonyms
- Go to Settings → Lumenare Search → Search Quality
- Find Synonyms section
- Add synonym groups (one group per line, comma-separated):
car, automobile, vehicle phone, smartphone, mobile laptop, notebook, computer - Click Save Settings
Note: Synonyms work immediately – no reindexing required.
Format
Correct:
- One group per line
- Words separated by commas
- Spaces after commas optional
- Case-insensitive
- At least two members per group
Examples:
car, automobile, vehicle
phone, smartphone, mobile, cellphone
configuration, config
Incorrect:
car automobile vehicle (missing commas)
Use Cases
Product Variations
Example:
laptop, notebook, computer
phone, smartphone, mobile, cellphone
television, telly
Why: Users search with different terms for same products.
Technical Terms
Example:
configuration, config
authentication, auth
documentation, docs
Why: Visitors may use an abbreviation while your content uses the longer word.
The keyword index stores individual words, not complete multiword aliases. A definition such as API, application programming interface therefore does not guarantee that an API query retrieves every page containing the full phrase. Normal keyword extraction also drops terms of two characters or fewer, such as WP or TV. Test acronyms and multiword aliases with real indexed content before relying on them; phrase boosting only changes the ranking of already-eligible results.
Common Variations
Example:
login, logon
signup, registration
setup, configuration
Why: Alternate vocabulary, when the words are equivalent in your site's context. Punctuation and multiword forms need their own retrieval tests.
Regional Variations
Example:
color, colour
organize, organise
center, centre
Why: Different spelling conventions.
Best Practices
Keep Groups Focused
Good:
car, automobile, vehicle
phone, smartphone, mobile
Avoid:
car, automobile, vehicle, transportation, travel, journey
Why: Too broad groups reduce precision.
Test Your Synonyms
After adding:
- Test searches with synonym terms
- Check whether the intended indexed variations appear
- Check relevance is maintained with the actual match mode and filters
- Adjust if needed
Start Small
Begin with:
- Most important synonym groups
- Terms you know users search for
- Common variations in your content
Expand based on:
- Search analytics
- Zero-result queries
- User feedback
Examples
Example 1: Product Catalog
Synonyms:
laptop, notebook
phone, smartphone, mobile
television, telly
car, automobile, vehicle
Search: "laptop"
Can find: Eligible indexed posts with "laptop", "notebook", or both
Example 2: Technical Documentation
Synonyms:
configuration, config
authentication, auth
documentation, docs
Search: "config"
Can find: Eligible indexed posts with "config" or "configuration"
Example 3: Multilingual Content
Synonyms:
hello, hola, bonjour
car, auto, coche, voiture
Search: "car"
Can find: Eligible indexed posts with "car", "auto", "coche", or "voiture". These are manually configured equivalents, not automatic translation.
Impact on Search
Positive Effects
Expanded Coverage:
- Users find content with different terms
- Reduces zero-result queries
- Better user experience
Improved Discovery:
- Content more discoverable
- Less dependent on exact wording
- More inclusive results
Considerations
Relevance:
- Synonyms should be truly equivalent
- Too broad groups reduce precision
- Test to ensure relevance maintained
Performance:
- Synonyms add bounded keyword lookups; measure the effect on your site's query volume
- Synonym expansion itself does not call an AI service
- Optional embeddings and AI answers have separate preparation and provider costs
Other search settings:
- Configured stop words are excluded from synonym expansion
- The supplementary synonym pass does not guarantee strict All logic across every original term
- Synonyms can improve retrieval, but a related hit alone does not prove an answer; cited excerpts and AI answers still require supporting source passages
Troubleshooting
Synonyms Not Working
Check:
- Synonyms are saved correctly
- Format is correct (one group per line, comma-separated)
- No typos in synonym definitions
- Group members exist as searchable words in the index, and are not configured stop words
Solutions:
- Verify format
- Check spelling
- Test with content that contains synonyms
- Review synonym configuration
Too Many Results
Symptoms:
- Synonyms too broad
- Irrelevant results appearing
Solutions:
- Make synonym groups more specific
- Remove overly broad synonyms
- Test and refine groups
- Review search results
Synonyms Too Restrictive
Symptoms:
- Missing equivalent terms
- Users not finding content
Solutions:
- Add more synonym groups
- Review zero-result queries
- Identify missing variations
- Expand synonym lists
Advanced Tips
Based on Analytics
Use Search Analytics:
- Review zero-result queries
- Identify term variations
- Add synonyms for variations
- Test and refine
Content Analysis
Review Your Content:
- Identify equivalent terms used
- Group related terms
- Add as synonyms
- Test searches
User Feedback
Listen to Users:
- Note search complaints
- Identify term mismatches
- Add synonyms
- Improve discoverability