This article outlines how to troubleshoot issues with the search backend related to synonyms.
Be sure to follow the How to Start Debugging Backend Search Issues help article for general troubleshooting steps first.
General Troubleshooting Steps
- Check the tokens the search is comprised of: The tokens of the query will impact which synonyms are applied. This is shown in the search factors box on the right side of the search log.
- If the token is different from the synonym, the synonym will not be applied. Check the synonyms configured in step 2.
- If there are words in the search query that are not identified as tokens, they are either a built-in stop word (e.g. “or”, “of”, or “in”) or an additional stop word. Check the additional stop words property following the steps above and remove the term if needed.
- Navigate to Search > [[Experience Name]] > General Settings.
- Under Additional Stop Words, remove the term.
- Check synonyms configuration: Make sure synonyms are configured correctly as intended.
- Navigate to Search > [[Experience Name]] > Synonyms.
- Confirm the synonyms are configured correctly.
- Check for the correct configuration between one-way synonyms, normalization synonyms, and synonym sets. Review the differences in the Synonyms module.
- Check for typos and alternate forms of the word.