Configure modern search results to search all of your organization (rather than the current site)


Hey everyone,


We heard from many of you the need to be able to change the scope of your modern search results pages. When you create a new communication site or team site in SharePoint Online today, and type into the search box, you are taken to the modern search results page. This page shows results from your current site by default, and allows you to expand the scope of your search to the hub that the current site is associated with (if there is one), or to the whole organization.


But there is a desire for being able to change the behavior to always search over the whole organization, or across the hub a site is associated with, without needing an additional click, especially if the site in question will be used as a modern landing page for your organization. 

Searching in a site will show results from that site (Strategy and Planning), with a control to expand the search scope to the hub (Sales) or the whole organizationSearching in a site will show results from that site (Strategy and Planning), with a control to expand the search scope to the hub (Sales) or the whole organization

I'm happy to say that with the latest version of the SharePoint PnP PowerShell extensions, it is possible to run a simple command as the site owner, and make your site use the organization, or the hub scope by default.


To change this setting:

1. Start PowerShell in administrator mode as you will be installing the PnP extensions.

2. Run the following commands to in this order:

PS C:\WINDOWS\system32> Install-Module SharePointPnPPowerShellOnline
# If you previously had installed this module, you may need to use the "-Force" parameter to install the newer version.
PS C:\WINDOWS\system32> Connect-PnPOnline -Url -UseWebLogin
# this will prompt you to sign into your site. Use the site owner credentials to sign in
PS C:\WINDOWS\system32> $web = Get-PnPWeb PS C:\WINDOWS\system32> $web.SearchScope = 1
# 1 for Tenant, 2 for Hub, 3 for Site, 0 for default behavior
PS C:\WINDOWS\system32> $web.Update() PS C:\WINDOWS\system32> Invoke-PnPQuery

After running these commands, the site will start to show results from the whole organization.After the change, results from the whole organization are displayed.After the change, results from the whole organization are displayed.To go back to the default setting, run the commands again with the value provided to "SearchScope" parameter to 0. 


To search across the Hub, use 2 as the SearchScope value.


We will be providing a way to set this setting using the UI in a future release as well.
Updated in April 2020 to reflect the ability to search across Hubs.

73 Replies

@Kerem Yuceturk 


Hello Kerem.  Two questions about this setting:

  • Does this apply to the new Global MS Search bar at the top as well?
  • Will changing this turn off library searching?


Thanks in advance!

Hi @tg_olympus, Yes, this will take effect for the new search box in the header as well.


This only applies to modern site search results.  Lists and Libraries will continue to search in that particular list or library. If you click on the link at the bottom of lists and libraries to expand the search, you will be able to get to modern site search results, which will respect this setting. 

@Kerem Yuceturk


Cool, we just tried it.  It works to a point but it seems to be still showing local results in the search results drop down.  Would that be fixed up in the future?



Thank you @tg_olympus! Yes, making the suggestions that appear under the search box to have the same scope is something the team is working on.

@Kerem Yuceturk 


I have updated the search scope using powershell on comms/teams site but still the results are getting redirected to site level


Powershell Result after running the script on site  :  $web.SearchScope


Can you confirm if i am missing something

@Kanwar Jot Singh 



Are the results that are not tenant wide in the searchbox or is it on the search results page after performing a search by hitting enter in the searchbox?


Also to verify that your site has been set to tenant you can try adding /_api/web to the end of the site url and searching in the text in the browser for searchscope and what value is set there.

@Geir-Magnus Pettersen 


Powershell result : SearchTenant.png


Search result in the site url after the change >> _layouts/15/search.aspx/siteall?q=keyword?




@Kanwar Jot Singh 


Setting looks correct, one thing we are working on is enabling hub sites for honoring the search scope. This is currently work in progress, so one source of this is if your communication site could be set up as hubsite? 


Could you please verify that your site is not a hubsite?

@Geir-Magnus Pettersen


No communication site is not a hub site, i also tested on Modern team site but it also did not work on that one also. 

@Kanwar Jot Singh, sending you a private message where we can try to figure out your specifics. 

Worked like a charm on my primary hub (comm) site. Thanks!
I noticed you can no longer see the Q&A cards in search results. Is this a known issue?
Is there any fix coming for team site as the feature doesn’t work on team sites

@Kerem Yuceturk  Greetings - Are there plans or is there a way to control what is displayed in the result details? For example we have a description in the page details, but the results return the first few lines on the page. Same with libraries or lists. Return title or subject information? 


~ Catherine

@RickyB, we noticed the issue as well where some of our users were not seeing the result cards, and addressed it recently. All Targeted Release users and tenants should see the answer cards now while they are searching at the organization level. We hope that this will be available more broadly by September. 

@Catherine Billick, we are working on a feature called modern display templates that will allow you to do this. My best estimate at the moment is that this will be available in the first half of 2020, we can provide a better estimate as we make more progress in our implementation.   

@Kerem Yuceturk - Super!  The feature will help the results be more user-friendly.  Thanks for the quick reply.

@Kerem Yuceturk 


I came here specifically looking for this feature, thank you for posting. Looking forward to updates to make it easier.