Skip to content

Synonyms Support

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

  1. Go to Settings → Lumenare Search → Search Quality
  2. Find Synonyms section
  3. Add synonym groups (one group per line, comma-separated):
    car, automobile, vehicle
    phone, smartphone, mobile
    laptop, notebook, computer
    
  4. 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:

  1. Test searches with synonym terms
  2. Check whether the intended indexed variations appear
  3. Check relevance is maintained with the actual match mode and filters
  4. 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.

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:

  1. Synonyms are saved correctly
  2. Format is correct (one group per line, comma-separated)
  3. No typos in synonym definitions
  4. 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:

  1. Review zero-result queries
  2. Identify term variations
  3. Add synonyms for variations
  4. Test and refine

Content Analysis

Review Your Content:

  1. Identify equivalent terms used
  2. Group related terms
  3. Add as synonyms
  4. Test searches

User Feedback

Listen to Users:

  1. Note search complaints
  2. Identify term mismatches
  3. Add synonyms
  4. Improve discoverability

← Back to Documentation Home | Fuzzy Matching →