Use this article when a Ranking change does not move the expected result higher, or when short queries return too many broad or weak results. Troubleshooting works best when you compare the expected result with the results that still rank higher and identify which factor caused the difference.
Troubleshoot a Boost That Does Not Move a Result
A boost increases the influence of a relevance factor. It does not replace the rest of relevance scoring.
A boosted result can still rank lower when:
- it weakly matches the visitor's query
- another result matches more query terms
- another result matches in stronger fields, such as title or description
- another result matches rarer terms that carry more scoring weight
- the boosted field is missing, empty, or inconsistent
- other Ranking boosts, Rules, Promotions, Smart Ranking, or Sorting behavior also affect visible order
This is expected. Boosts guide relevance. They do not force placement.
For a deeper explanation of how text matches, field statistics, and boosts combine, see How SearchStax Calculates Relevance Scores.
Check Whether the Boost Applies
First, confirm that the expected result qualifies for the boost.
Check that:
- the boosted field exists in the Site Search index
- the field is populated on the result you expected to influence
- the field value matches the configured boost value
- capitalization, pluralization, spacing, and formatting are consistent
- the current published configuration includes the boost
If the field is missing or inconsistent, fix the source data, crawler or connector mapping, or indexing process before you rely on the boost. If you cannot confirm the indexed field or value in the Site Search interface, work with the team that manages indexing.
Check Searchable Signals
Next, review the expected result's indexed title, description, headings, summaries, and body text. Confirm whether the result contains the visitor's query terms or configured synonyms in fields SearchStax searches. Check whether those matches appear in focused fields, such as title, description, headings, or summaries, or only in broad body content.
If the expected result does not match the query strongly, a boost may not be enough. Improve the page title, description, headings, summary, or metadata, or review Search Fields before increasing the boost.
Then compare the expected result with two or three results that still rank higher. They may have:
- stronger field matches
- more complete query-term matches
- rarer terms that contribute more to scoring
- other boosts that apply
- recency, URL, content type, page type, or custom-field values
- Rules, Smart Ranking, Promotions, or sort settings that affect visible order
Choose the smallest fix that matches the problem. Adjust Search Fields when the right content does not match strongly enough. Correct metadata when the boost depends on a missing or inconsistent field. Adjust boost strength when the signal is valid but needs more or less influence. Use a Rule for query-specific behavior. Use a Promotion for fixed placement.
Troubleshoot Short or Broad Queries
Short searches such as events, news, programs, tuition, admissions, blog, or AI give SearchStax fewer clues about intent. A one-word query can match many pages, especially when the word appears in body content, navigation text, repeated page elements, or broad metadata.
Common causes include:
- body content has too much influence
- Search Fields include low-value or repeated fields
- titles, descriptions, headings, or summaries are weak or empty
- structured metadata is being used like broad searchable text
- the query is genuinely ambiguous
- a boost helps a broad group that includes weak pages
- Rules, Smart Ranking, Promotions, or sort settings change visible order
Start by writing down the likely visitor intent. Use analytics or recent search logs when available. For each short query, record the content types that should usually appear, known pages that should be easy to find, and related queries with clearer intent, such as upcoming events, academic programs, or admissions requirements.
Then review Search Fields. Focused fields such as title, description, headings, and summaries should carry enough influence. Long body fields can support recall, but they can also push weak matches too high. Repeated navigation text, footer text, boilerplate content, or broad metadata can also create noise.
If broad body content overwhelms focused fields, tune Search Fields and Ranking in small steps. You might remove fields that create mostly noisy matches, give focused fields more influence, reduce body influence, or use reliable structured metadata for Ranking.
Choose the Smallest Fix
Match the fix to the cause:
- Improve page titles, descriptions, headings, or summaries when useful content lacks focused searchable text.
- Adjust Search Fields when low-value fields, repeated text, or broad body content create too many weak matches.
- Use Ranking to give focused fields or reliable structured fields more influence across many relevant searches.
- Correct metadata when a useful Ranking field or value is missing, empty, inconsistent, or mapped to the wrong field.
- Review sort settings when result order does not respond to relevance tuning.
- Use a Rule when one ambiguous query needs behavior that should not apply broadly.
- Use a Promotion when a specific result must appear in a promoted placement.
Avoid creating a Rule or Promotion for every noisy query before you review Search Fields and Ranking. Too many query-specific fixes make relevance harder to understand and maintain.
After each fix, rerun the same test set. Confirm that useful results moved higher without hiding useful secondary results or weakening other important queries.
Check the Baseline for AI-Powered Results
Smart Answers and Smart Ranking are easier to evaluate when SearchStax can retrieve and rank useful results for the query. If the top results are weak, noisy, or missing the right content, Smart Answers has weaker source material to use when it selects and prioritizes source content. Smart Ranking reorders results after other filtering, ranking, and boosting features, so the baseline result set still matters.
Promotions may also affect the content available to Smart Answers, depending on the query and configuration. When a relevant promotion exists for a query, Smart Answers prioritizes that promotional content when generating answers. That means a Promotion can affect both the visible result list and the content sources used for an AI-powered answer.
Before you evaluate Smart Answers or Smart Ranking, run the queries you care about and review the top results without focusing on the AI output first. Confirm that Search Fields, Ranking, metadata, and any targeted Promotions produce useful source results.