How to Troubleshoot Promoted Result Does Not Appear for a Keyword

You configured a promoted result in SharePoint Search for a specific keyword, but the result does not show when users search for that term. This problem often occurs because of a mismatch between the query rule settings and the search index or because the promoted result is blocked by another rule. This article explains why a promoted result may not appear and provides step-by-step instructions to fix the issue. You will learn how to check query rules, promoted result definitions, and search service application settings.

Why a Promoted Result Does Not Appear for a Keyword

A promoted result, also called a best bet, is a search result that you force to appear at the top of search results for a specific keyword. In SharePoint, promoted results are defined within a query rule. When the rule’s condition matches the user’s search query, the rule triggers and displays the promoted result. The promoted result does not appear when one or more of the following conditions are true:

The query rule itself is not active, or it is targeted to the wrong result source. For example, a rule set to apply only to the Local SharePoint Results source will not fire when a user searches from a search center that uses a different result source. The promoted result’s URL may be broken, or the content at that URL may not be indexed. If the search crawler cannot reach the URL, or if the item is excluded from search by permissions or crawl rules, the result will not render. Another common cause is rule priority conflicts. If multiple query rules match the same keyword, only the rule with the highest priority executes. A lower-priority rule’s promoted result is ignored. Also, if the promoted result is defined but the query rule condition uses a different keyword or a complex condition that does not match the user’s exact query, the result will not show.

Steps to Diagnose and Fix the Promoted Result Issue

Follow these steps in order. After each step, test the search query to see if the promoted result appears.

1. Check the query rule status and scope
   Go to SharePoint admin center > Search > Query Rules. Select the result source that applies to your search scenario, for example Local SharePoint Results. Locate the rule that contains the promoted result. Verify that the rule is set to Active. If it is Inactive, edit the rule and change the status to Active. Also confirm that the rule is published. A rule in draft state will not fire for end users.
2. Verify the query rule condition
   Open the query rule and examine the condition. The condition must match the exact keyword that users type. For a simple keyword match, use the condition Query Action Matches Keyword Exactly or Query Action Contains Keyword. If you use a regular expression or a complex condition, test it with a sample query. Make sure there are no spelling errors or extra spaces. For example, a condition set to match the keyword “budget” will not match “budget report”.
3. Examine the promoted result definition
   Inside the query rule, under the section Promoted Results, click the promoted result to edit it. Check the URL. The URL must be a full, valid URL that starts with http or https. The content at that URL must be crawled and indexed. To verify indexing, perform a search for the URL itself. If the URL does not appear in search results, the item is not indexed. Also confirm that the title and description fields are filled. An empty title may cause the result to be suppressed.
4. Check rule priority and order
   In the query rules list, note the order of rules. Rules are evaluated in the order they appear. The first rule that matches the query is applied. If a higher-priority rule also matches the same keyword, it may block your promoted result. Move your rule higher in the list by selecting it and using the Move Up button. Alternatively, edit the higher-priority rule to remove the conflicting condition.
5. Verify the result source assignment
   Ensure that the query rule is assigned to the correct result source. In SharePoint admin center, go to Search > Result Sources. Identify the result source that your search page uses. Then go back to Query Rules and confirm that the rule is listed under that result source. If the rule is under a different result source, either move the rule or change the search page to use the correct source.
6. Test with a fresh search index
   If the promoted result still does not appear, trigger a full crawl of the content source that contains the URL. In SharePoint admin center, go to Search > Crawl Log. Check if the URL was crawled successfully. If the crawl shows an error, fix the cause. After the crawl completes, re-test the keyword.
7. Clear the search results cache
   SharePoint caches search results for a short period. To force a refresh, append the query string ?force=1 to the search results page URL. For example, https://yourtenant.sharepoint.com/search/Pages/results.aspx?k=budget&force=1. If the promoted result appears with this parameter, the issue is cache-related. Wait for the cache to expire or instruct users to refresh the page.

If the Promoted Result Still Does Not Appear

The promoted result appears for some users but not others

This usually indicates a permissions issue. The user must have at least Read access to the item at the promoted result URL. If the item is a document in a library with unique permissions, grant the user access. Also, if the item is excluded from search by a crawl rule or a security trimmer, it will not appear. Check the crawl rules in SharePoint admin center > Search > Crawl Rules. Ensure that no rule excludes the URL path.

The promoted result appears in the search center but not in a site collection search box

Site collection search boxes may use a different result source. For example, a team site search box typically uses the Local SharePoint Results source, while a search center may use a custom source. Create a separate query rule under the same result source that the site collection uses. Alternatively, change the site collection’s search settings to point to the same result source as the search center.

The promoted result shows only when I type the exact keyword with correct capitalization

SharePoint search is not case-sensitive by default. If your query rule condition uses a regular expression that is case-sensitive, it will not match variations. Edit the query rule condition and remove case-sensitive flags. Use the condition Query Action Contains Keyword instead of a regular expression for simple keyword matching.

Check	What to Look For	Action
Query rule status	Active or Inactive	Set to Active and publish
Query rule condition	Exact keyword match	Use Query Action Matches Keyword Exactly
Promoted result URL	Valid, crawlable URL	Verify indexing and permissions
Rule priority	Order in the list	Move rule higher if blocked
Result source	Assigned source matches search page	Reassign or change search page source

You can now systematically check each setting that controls promoted results. Start with the query rule status and condition, then move to the promoted result URL and rule priority. After you apply these fixes, test the keyword search again. For a long-term solution, document the query rules and promoted results in your environment. Use the search service application’s diagnostic logging to trace rule firing events if the issue recurs.