Set up Viva Engage for a multitenant organization

Important

Multitenant organization is available for Viva Engage on a roll-out basis. To configure this feature for your organization, contact your Microsoft Account Manager or Support.

Multitenant organization is a Microsoft 365 feature that allows complex and distributed organizations to communicate as a unified network. By configuring a tenant group in Microsoft 365 of trusted tenants in your organization, cross-tenant engagement is possible in Viva Engage. Learn more about multitenant organizations.

Complete these tasks in the order they appear. Administrator role requirements vary by task and are called out in each section.

Note

This experience is only available by cohort-based rollout.

---

Tenants connect in hub-and-spoke model

Viva Engage uses a hub-and-spoke model to communicate across tenants. The hub rests at the center and is the tenant that generates most of the organization's content. The hub should be the tenant where your identified leaders (for example, corporate communicators, HR, and policy makers) reside.

Spoke tenants are the remaining networks. By using storyline and Leadership corner, leaders on the hub can broadcast content to all spoke tenants simultaneously, ensuring that information is distributed in a timely and efficient manner.

After the hub tenant is configured for multitenant organization, all tenants can communicate as a single, unified network.

Note

Only Storyline and Leadership corner are available for multi-tenant organization.

Requirements

To access the multiple tenant organization feature for Viva Engage, your organization must meet these requirements across all tenants.

Microsoft 365 requirements

• Microsoft 365 E3 and Microsoft Entra ID P1. Or, Microsoft 365 E5 license (includes Microsoft Entra ID P2)
• Microsoft Entra ID manages all networks
• Microsoft Graph API

Viva Engage requirements

• Internal communications or IT manages Viva Engage
• Networks are in Native Mode
• Networks are not in a one-to-many state. Each tenant can have only one Viva Engage network. See Network migration - Consolidate multiple Viva Engage networks.
• Full trust is established between all tenants. To establish full trust, configure your organizational settings.
• All users in all tenants have access to Microsoft Viva Suite or Communications and Communities
• Storyline is enabled on the hub tenant

Prepare to set up a multitenant organization

For Microsoft 365 Global administrators

This task assumes that all requirements for Microsoft 365 and Viva Engage are met. When designing an effective multitenant organization, it’s crucial to establish a hub within the tenant where most essential communication originates. Leaders, corporate communicators, human resources, and policy makers drive most of the messaging for the organization. Therefore, these roles need to be in the hub tenant. Multitenant organization controls are available only to users internal to the hub tenant.

Task description	Instructions
A. Plan out your multitenant organization.	See Plan for multitenant organizations.
B. Determine the network configuration model for your organization.	List all Microsoft Entra ID managed tenants in the organization. Of the tenants in your organization, decide which one is the hub. Other tenants are considered spoke tenants. For each spoke tenant, clarify the scope of users to synchronize to the Hub tenant. How you configure multitenant organization in Microsoft Entra ID affects which users are able to participate in each tenant.
C. Designate an Engage, global, or network administrator to configure the multitenant organization. This role must reside in the hub tenant.	If you need a new admin role, see how to assign admin roles in Microsoft 365 admin center or PowerShell.

Configure the multitenant organization in Microsoft 365

For Microsoft 365 Global administrators

This process requires that you use Microsoft Graph API, an API with separate requirements and prerequisites. Learn more about the Microsoft Graph API.

Task description	Instructions
A. Configure the multitenant organization and participating tenants in the Microsoft 365 admin center.	Sign into the owner tenant and create a multitenant organization. Add all tenants to the multitenant organization. See Configure a multitenant organization using the Microsoft Graph API
B. Generate the multitenant organization trust policy. Configure the policy template to correspond to partner configurations.	Configure a policy from these templates.
C. Synchronize across the multitenant organization.	See Configure cross-tenant synchronization.
D. If you run into problems, troubleshoot the issue.	See Known issues for multitenant organizations.

Configure Viva Engage for multitenant organization

For Microsoft 365 Global administrators

After you establish the multitenant organization in Microsoft 365, configure multitenant organization controls for Viva Engage on the tenant you've designated as the hub.

Note

Licensing and other tenant-specific controls remain under control of that tenant’s admin. However, the spoke user license applies to the hub network.

Task description	Instructions
On the designated hub tenant, configure Viva Engage to recognize the tenant as the hub.	In the Viva Engage Teams application, select the ellipses button from the top navigation menu and select Admin. On the Feature management tab, select the MTO policy tile. Select the hub tenant.

Configure the hub tenant for Storyline

For the Engage, global, or network admin on the hub tenant

From the hub tenant, configure Storyline settings to make announcements and leadership posts available across all tenants.

Task description	Instructions
A. Enable storylines for Viva Engage.	Sign in to as administrator. Go to the Viva Engage Admin center. On the Feature management tab, select Storyline. Turn on the Enable Storyline toggle.
B. Configure storylines for multitenant organization.	Follow the preceding steps 1-3 to go to the Storylines settings. Select Advanced settings. Under Multi-tenant organizations (MTO), select the check box for Let users on spoke tenants engage in storyline posts from this network. For more details, see Enable storyline.

Manage leadership for the multitenant organization

For the Engage admin, verified admin, network admin, or corporate communicator

On the hub tenant, enable audiences and specify the leaders whose storyline posts reach all tenants in the multitenant organization.

Task description	Instructions
A. Add leaders to the multitenant organization	Sign in to as administrator. Go to the Viva Engage Admin center. On the Feature management tab, select Leadership identification and audiences. On the Manage leaders page, select Add leader, and type the leader’s name. When the name appears in the search, select the Add button next to it. Select the Edit button next to that leader’s name. Turn on Entire organization: [TENANT_NAME]. Entire organization refers only to the tenant that you're configuring. This option only enables the leader to communicate on the hub tenant. Turn on Multiple organizations to enable the leader to communicate across all tenants in the multitenant organization from their storyline.
B. Enable audiences for the multitenant organization	On the Feature management tab, go to Leadership identification and audiences, and select the Manage audiences page. Turn on Entire organization: [TENANT_NAME]. Entire organization refers only to the tenant that you're configuring. In other words, this option enables the leader to communicate with the hub tenant. Turn on Multiple organizations to let leader posts and announcements reach across all spoke tenants in the multitenant organization.