Support for WordPress Multisite WPMU

Use this guide if you want to configure the WordPress Multisite capability of the WordPress + Office 365 plugin.

Before you start

  • You have reviewed the installation prerequisites and have installed but not yet activated the plugin (see Getting started - Installation).
  • You are a Global Administrator for your company’s Office 365 tenant / Azure AD directory (or have at least the ability to create (or edit an existing) Azure Active Directory App registrations).
  • You are an Administrator for your WordPress website.

Network activate the plugin

The plugin must be network activated.

  • Go to My Sites > Network Admin > Plugins.
  • Click Network activate.

Network Activate does pretty much what you thought it does: It activates the plugin on all sites in the network. It also takes it out of the default Plugin view on the plugins screen for all those sites, so they no longer have the option to either activate it or deactivate it.

Choose a WordPress Multisite Mode

network administrators now must choose one of two possible configurations:

  • Shared All subsites in the network share the same Azure AD App registration and all users 'enter' the network through the main site and gain access to all subsites with a single login.
  • Dedicated Each site in the network is treated isolated from the other and each one will have to be configured individually. It is still possible to use a single Azure AD App registration but at the very least you'll need to add each site's URL as Redirect URI.

The shared scenario doesn’t need to be configured, as it’s the default scenario. Only if you’d like all sites in the network to have their own Azure AD application registration, you need to update your configuration and add the following line to your wp-config.php

define( 'WPO_MU_USE_SUBSITE_OPTIONS', true );
immediately below the line
/* That's all, stop editing! Happy publishing. */
If you don’t add this line or add it but set WPO_MU_USE_SUBSITE_OPTIONS to false, the plugin will select the shared scenario.
To configure the plugin and single sign-on, as an administrator, you will need to navigate – in case of the shared scenario – to My Sites > Network Admin > Dashboard and then click WPO365 from the main admin menu on the left. 
On the other hand – in case of the dedicated scenario, administrators can navigate to each individual site’s Dashboard and then click WPO365 from the main admin menu on the left.

Single sign-on

To configure the single sign-on capability of the WordPress + Office 365 plugin for either scenario, please consult the Getting started - Single sign-on documentation. 
Please keep in mind that when you opt for the Dedicated scenario you can basically use one and the same Azure Active Directory App registration for all subsites but at the very least you'll need to add each subsite's URL as separate Redirect URI on the App registration's Authentication page.


To configure the Integration (e.g. with Microsoft Graph and SharePoint Online) capability of the WordPress + Office 365 plugin for either scenario, please consult the Getting started - Integration documentation.


When you configure the shared scenario e.g. for (with subsites, etc.) you may need to edit your wp-config.php file and add the line 

define('COOKIE_DOMAIN', '');

just below the line that reads 

/* That's all, stop editing! Happy publishing. */

(obviously you would need to replace with your own domain).

User synchronization

The PREMIUM and INTRANET edition's User synchronization feature is only really suited to work well  for the shared scenario and only synchronizes users to the main site. Currently the plugin doesn't have any external knowledge of how to assign users to subsites.

Multisite domain mapping

WordPress multisite subsites may be mapped to a non-network top-level domain. This means a site created as, can be mapped to show as In this case, unfortunately, currently single sign-on won't work as expected.

Related configurations

If you combine the power of WordPress Multisite and the WordPress + Office 365 plugin, you can also
  • Redirect users from a central login to their subsite by configuring a mapping table between Azure AD groups on the one and WordPress subsites on the other hand read more.
  • Configure a default role for a new user for a subsite read more.
Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.