Customize query suggestions in SharePoint search

Query spelling suggestions are words that appear below the search box as a user types a query. SharePoint automatically creates a query suggestion when you've clicked a search result for a query at least six times. For example, if you've entered the query word "coffee" and then clicked a search result six times, "coffee" automatically becomes a query suggestion.

Automatic query suggestions are generated daily for each result source and each site collection, so the query suggestions can be different for different result sources and site collections.

SharePoint Online has both a classic and a modern search experience, learn about the differences between the classic and modern search experiences in SharePoint Online. The modern search experience uses the same default result source as the classic search experience. Automatic query suggestions for the default result source appear in both the classic and modern search experiences.

You can manually create your own lists of query suggestions and import them to SharePoint. Manual query suggestions apply to all result sources, all site collections, and to both search experiences.

To create query suggestions for multiple languages, you'll need to create a separate file for each language. The language determines how the query suggestions are processed internally in the search system. All manual query suggestions are always displayed for all languages. Add each phrase as a separate line in the text file that you create and save the file in UTF-8 encoding.

Query suggestions are turned on by default. To turn them off, go to Search Suggestions and uncheck Show search suggestions.

  1. Sign in to as a global or SharePoint admin. (If you see a message that you don't have permission to access the page, you don't have Office 365 administrator permissions in your organization.)


    If you have Office 365 Germany, sign in at If you have Office 365 operated by 21Vianet (China), sign in at Then select the Admin tile to open the admin center.

  2. In the left pane, under Admin centers, select SharePoint. (You might need to select Show all to see the list of admin centers.)

  3. If the classic SharePoint admin center appears, select Open it now at the top of the page to open the new SharePoint admin center.

  4. Select Classic features.

  5. Under Search, select Open.

  6. Select Query Suggestion Settings on the search administration page.

  7. Open a text editor of your choice, and enter a list of terms that you want the system to always suggest to users. Only add one term per line to the text file, and don't mix languages in the text file.

  8. Save the text file to a location that's accessible from SharePoint Online.

  9. To import a list of query suggestions to SharePoint search, go to Always suggest phrases > Import from text file. When you import query suggestions, any existing ones will be overwritten.

  10. Browse to the file that you want to import.

  11. Go to Language for suggestion phrases, and select the processing language of your query suggestions. It should match the language of the terms in the text file.

  12. Choose Save Settings.

You can edit a list of query suggestions that you've manually created. To edit a list that you've already imported in to SharePoint, choose Export to text file, update the text file with your changes, and then re-import it. After you've uploaded your query suggestions file, it might take a few hours until your query suggestions are displayed. You can check that they're working properly by entering a phrase from your list of query suggestions in the search box. The query suggestion should appear below the search box.

To get rid of a list of query terms, you must overwrite it. Do this by importing an empty text file.

You can also prevent terms from appearing in the search box. To do this, create a text file with the query terms that you never want users to see below the search box, and then import it to Never suggest phrases.