Hybrid picker in the SharePoint Online admin center

APPLIES TO: yes2013 yes2016 yes2019 yesSharePoint Online

What is the Hybrid Picker?

Hybrid Picker is a wizard that can be downloaded to your SharePoint Server from Office 365. The wizard helps automate certain configuration steps needed to connect your on-premises SharePoint Server environment with SharePoint Online in Office 365. The Hybrid Picker wizard is your assistant, designed to do some of the work for you.

Use the Hybrid Picker wizard to redirect OneDrive for Business to SharePoint Online, leverage hybrid site features or app launcher, and add some extra integration between on-premises SharePoint Server and an extranet site made in Office 365. Hybrid Picker also creates a Server-to-Server (S2S)/OAuth connection for your SharePoint Hybrid features.

Using the Hybrid Picker

First, you need to make sure you meet the prerequisites in your SharePoint Server on-premises farm, then you can run the Hybrid Picker wizard.

Prerequisites to run the Picker

The Picker requires the .NET Framework 4.6.2 in order to run.

The following are the account requirements to run the Hybrid Picker. You must be:

  • A member of the Farm Administrators group

  • A service application administrator (Full Control) for the User Profile Service

  • An Office 365 Global Administrator

  • Logged into Office 365 and SharePoint Server from a server in your SharePoint Server farm

  • Able to launch the Hybrid Picker as a Farm Administrator with elevated permissions

The account that you use must not use multi-factor authentication.


The Hybrid Picker wizard must be launched from an on-premises server with SharePoint Server 2013 or SharePoint Server 2016 installed. Launch it in the environment you want to use for your SharePoint hybrid.

SharePoint hybrid features offered in the Hybrid Picker

Use the Hybrid Picker to either configure, or assist with the configuration of, hybrids that connect Office 365 and your on-premises SharePoint environment.

The Hybrid picker helps with or completes the setup of these hybrid features:

  • Hybrid OneDrive - Choosing this option will redirect on-premises My Sites/OneDrive for Business sites to SharePoint Online OneDrive for Business in Office 365. Once the wizard completes, any click of the OneDrive link from on-premises will redirect to OneDrive for Business in the cloud. Your redirection will be complete and users can begin to migrate any files to their online OneDrive. This option also sets up hybrid user profiles. When users click to view a profile, they will be redirected to the profile in Office 365.

  • Hybrid Sites Features - Choosing this option sets up hybrid sites features, a suite of site integration features, as well as OneDrive for Business redirection. Clicking this option configures hybrid OneDrive for Business and hybrid user profiles, hybrid site following, and the hybrid app launcher.

  • Hybrid App Launcher - This hybrid feature further integrates Office 365 with your on-premises SharePoint server farm by placing tiles like Office 365 Delve and Video (as well as custom Office 365 tiles you may have) on the on-premises SharePoint Server App Launcher. This option also sets up hybrid OneDrive for Business with user profile redirection, and sites features.

  • Business-to-business (B2B) extranet sites - Choosing this option will install extra features you can integrate with an extranet site you create in Office 365. With Office 365 extranet, partners can connect directly to a members-only site in Office 365 without access to the corporate on-premises environment or any other Office 365 site. Choosing this option sets up OneDrive for Business and user profile redirection, sites features, and hybrid app launcher.

  • **Hybrid auditing (SharePoint Server 2016 only) ** - This feature lets on-premises SharePoint Server 2016 administrators upload on-premises user activity logs to the Office 365Compliance Center. Administrators will be able to view user activities via Audit Log search from the Office 365 Compliance Center. No additional hybrid features will be set up with this option.

  • Hybrid Taxonomy - This feature allows a centralized taxonomy that's readable and writable in the Office 365 Cloud, to be used as a read-only copy on-premises. This feature includes Hybrid Content type (June 2017 PU required) which will replicate the published content types in Office 365 to on-premises. Choosing this option sets up OneDrive for Business and user profile redirection, sites features, and hybrid app launcher.

  • **Hybrid self-service site creation ** - This feature redirects the default self-service site creation page in SharePoint Server 2013 (/_layouts/15/scsignup.aspx) or SharePoint Server 2016 (/_layouts/16/scsignup.aspx) to the SharePoint Online Group Creation page. This setting can be configured independently for each web application in your farm. It helps your users create their sites in SharePoint Online instead of SharePoint Server.

  • Cloud hybrid search - Choosing this option creates a cloud Search service application in SharePoint Server and connects the cloud Search service application to your Office 365 tenant. This is one of the steps needed to set up cloud hybrid search, you must do the rest of the steps yourself (see the roadmap). This option doesn't include set-up of other hybrid features..


If the Hybrid Picker is run a second time with an enabled feature unchecked, this will not cause the feature to be uninstalled. Any additional selections will be installed and previously installed features will remain.

For all options, the hybrid picker configures a server-to-server trust between your SharePoint Server farm and Office 365.

Note that the hybrid picker does not uninstall features. If you run the hybrid picker and deselect a feature that you previously installed, it will remain installed.

To get started configuring hybrid features for your environment, choose from the following:

Hybrid Picker Prerequisite Checking

While running the Hybrid Picker, the wizard will check basic SharePoint farm settings that would otherwise block setup of essential hybrid building-blocks (such as OAuth/S2S Trust). This is why you should launch the Hybrid Picker from a server that will be part of your SharePoint hybrid. Some of the settings that are detected and checked while the configuration is run, include whether the:

  • SharePoint Server farm exists

  • Account is a farm administrator

  • SharePoint farm is a version that can function in a hybrid configuration

  • AppMangementServiceInstance is online

  • AppMangementServiceApplication is online

  • AppMangementServiceApplicationProxy is online

  • UserProfileApplicationProxy is online

  • The SPO365LinkSettings cmdlet (used to set the MySiteHostURL) is accessible on the server

The results of this testing can be viewed as a report if any prerequisite isn't met. If all prerequisites are met you will see green check-marks beside all the prerequisites, and will be able to continue your hybrid configuration.

Authentication realm update

As part of hybrid configuration, the hybrid picker updates the on-premises farm's authentication realm to match the Office 365 tenant context ID. After the authentication realm is changed, existing SharePoint add-ins fail to authenticate. The hybrid picker will attempt to fix this issue automatically. If the hybrid picker is not able to fix this issue or if you choose to fix it manually, follow the steps in Fix the HTTP 401 error with provider-hosted add-ins and issues with workflow and cross farm trust scenarios in SharePoint.

See also

Other Resources

You receive the error "Value cannot be null. Parameter name: My site URL or team site URL from Discovery Service is null or empty" when you use the SharePoint Hybrid Picker