When you set up a promoted result in Microsoft Search for a specific keyword, you expect that result to appear at the top of search results. Instead, the promoted result does not show up, and users see only organic results. This problem usually occurs because of a mismatch between the keyword configuration and how SharePoint search processes the query. This article explains the technical root cause behind this failure and provides a step-by-step fix to make your promoted result appear for the intended keyword.
Key Takeaways: Fixing Promoted Results That Do Not Appear in Microsoft Search
- Microsoft Search admin center > Results types > Promoted results: The keyword must match the exact query string after stemming and stop-word removal.
- SharePoint admin center > Search > Search schema: Managed properties with Searchable set to Yes are required for promoted results to match.
- Microsoft Search admin center > Promoted results > Edit keyword: Use the Exact phrase match type when the keyword contains multiple words.
Why a Promoted Result Does Not Appear for a Keyword
A promoted result is a search configuration that forces a specific URL to appear at the top of results when a user types a defined keyword. The feature works by matching the user query against the keyword you define in the Microsoft Search admin center. When the match fails, the promoted result is not returned.
The root cause is almost always one of the following:
1. Stemming and Stop-Word Interference
Microsoft Search applies stemming to user queries. Stemming reduces words to their root form. For example, a query for “running” is stemmed to “run.” If your promoted result keyword is “running shoes” but the user types “run shoes,” the stemmed query “run shoes” does not match your exact keyword “running shoes.” Stop words such as “the,” “and,” or “for” are removed from the query before matching. A keyword like “the best report” becomes “best report” after stop-word removal, and the promoted result may not match.
2. Keyword Match Type Is Too Restrictive
When you create a promoted result, you choose a match type: Exact phrase or Contains. Exact phrase requires the user query to be an exact match to the keyword after stemming and stop-word removal. If the user adds extra words before or after, the match fails. Contains allows the keyword to appear anywhere in the query, but it still requires the exact characters to be present.
3. Managed Property Searchability Is Disabled
Promoted results rely on the search schema to match keywords against content. If the managed property that stores the keyword text does not have the Searchable flag enabled, the search engine cannot index the keyword and cannot match it. This is rare for built-in properties but common for custom managed properties.
Steps to Fix a Promoted Result That Does Not Appear
Follow these steps in order. Test after each step to identify the specific cause.
- Check the keyword in the Microsoft Search admin center
Go to the Microsoft Search admin center athttps://admin.microsoft.comand select Search & intelligence. Under Customizations, select Promoted results. Find your promoted result and open it. Verify the keyword exactly as entered. If the keyword contains stop words, remove them. For example, change “the annual report” to “annual report.” - Change the match type from Exact phrase to Contains
In the same promoted result editor, locate the Match type dropdown. Switch from Exact phrase to Contains. This allows the promoted result to appear even if the user adds extra words to the query. Click Save and test the search. - Test the query after stemming
Determine the stemmed version of your keyword. Use a tool like the SharePoint Search Query Tool or manually test by typing the root word. If your keyword is “running reports,” test with the query “run reports.” If the promoted result appears, the issue is stemming. To fix this, update the keyword to its root form. For example, change “running reports” to “run reports.” - Verify managed property searchability
Go to the SharePoint admin center athttps://admin.microsoft.com/SharePoint. Select Search then Search schema. Find the managed property that corresponds to your keyword. For standard content, this is usually Title or Body. Ensure the Searchable checkbox is checked. If it is not, check it and click OK. A full crawl is required for the change to take effect. Request a crawl by going to Search > Manage search schema > Crawl log and selecting Start full crawl. - Clear the browser cache and retest
Search results are cached in the browser and in the search service. Clear your browser cache and cookies. Then test the search query again from a private or incognito window. If the promoted result appears now, caching was the cause.
If the Promoted Result Still Does Not Appear
Promoted result appears only for exact casing
Microsoft Search is case-insensitive by default. If your promoted result only appears when you type the keyword in a specific case, the issue is likely a custom result type or a managed property that is case-sensitive. Go to the SharePoint admin center and check the managed property. Under Advanced Searchable Settings, ensure Case insensitive is set to Yes. If it is No, change it to Yes and run a full crawl.
Promoted result appears for one site but not another
Promoted results are tenant-wide by default. If the result appears in one site collection but not another, the site may have a custom search scope or a result source that filters out promoted results. Go to the site collection and navigate to Site settings > Search result sources. Check if any result source has the Query transform that removes promoted results. Remove or modify the transform to include promoted results.
Promoted result is overridden by a higher-ranking result
If another promoted result or a bookmark has a higher priority, your result may be suppressed. In the Microsoft Search admin center, go to Promoted results and check the Priority column. A lower number means higher priority. If your result has priority 10 and another has priority 1, the priority 1 result appears. Edit your promoted result and set a lower priority number, for example 1.
Promoted Result vs Bookmark: Key Differences
| Item | Promoted Result | Bookmark |
|---|---|---|
| Description | Forces a URL to appear at the top of search results for a keyword | Displays a rich card with title, description, URL, and optional image |
| Appearance | Appears as a standard search result link | Appears as a card with formatted content |
| Keyword matching | Exact phrase or Contains | Exact phrase or Contains, plus synonyms |
| Use case | Direct users to a specific page for a specific term | Provide a quick answer or shortcut for frequently searched topics |
| Priority | Numeric priority (lower number wins) | Can be scheduled and grouped by date |
Now you can identify why a promoted result does not appear for a keyword and apply the correct fix. Start by checking the keyword match type and stemming behavior. Then verify the managed property searchability and run a full crawl if needed. For persistent issues, review result sources and priority settings.