Set up Viva Engage for a multitenant organization

2025-08-19

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 group of trusted tenants in your organization in Microsoft 365, you can communicate across those tenants in Viva Engage. Learn more about multitenant organizations.

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

The Storyline, Leadership corner, campaigns, and communities features support cross-tenant engagement in a multitenant organization.

Microsoft 365 requirements

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

Microsoft Entra P1 or P2 license, which is included in Microsoft 365 E3 or E5, and Microsoft 365 F1 or F3
Microsoft Entra ID manages all networks
Microsoft Graph API

Viva Engage deployment includes the following requirements:

Internal communications or IT manages Viva Engage
Networks are in Native Mode
Networks aren't in a one-to-many state. Each tenant can have only one Viva Engage network.
Full trust is established between all tenants. To establish full trust, configure your organizational settings.
All users in both hub and spoke tenants receive a Microsoft Viva Suite or Communications and Communities license
Storyline is enabled on the hub tenant. Refer to instructions in this article after the multitenant organization is set up.

Tasks for the Microsoft 365 Global administrator

Prepare to set up a multitenant organization

Complete these tasks in the order they appear. Since the role requirement varies by task, each section describes their respective requirements.

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 act as spoke tenants. For each spoke tenant, clarify the scope of users to synchronize to the hub tenant. The configuration of the multitenant organization in Microsoft Entra ID affects which users can participate in each tenant.
C. To configure the multitenant organization, designate an Engage or network administrator on the hub tenant.	If you need a new admin role, see Assign admin roles in Microsoft 365 admin center or use PowerShell for admin role assignment.

Configure the multitenant organization in Microsoft 365

Configuring the multitenant organization in Microsoft 365 requires Microsoft Graph API, which has its own requirements. 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 the multitenant organization

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

Note

Licensing and other tenant-specific controls remain under control of each tenant’s admin. Hub users don't need a duplicate license in the spoke tenants, and spoke users don't need a duplicate license in the hub tenant.

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.

Tasks for the Viva Engage admin or network admin on the hub tenant

Configure the hub tenant for Storyline

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 information, see Enable storyline.

Configure leadership on the hub tenant

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. 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.

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. 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.

Tasks for the Viva Engage admin

Enable communities for multitenant engagement

You can only enable preexisting communities on the hub tenant for cross-tenant engagement. Once enabled, the community becomes private.

Task description	Instructions
A. Enable a community for a multitenant organization.	1. In the hub tenant, go to the community landing page. 2. From the options menu in the community header, select Make visible to all organizations. 3. Confirm the change. The community is now available to all tenants as a private community, which requires each community admin to approve community members.
B. Add community members	The Engage admin or the community admin can add members in Microsoft 365 groups, with a CSV, or manually. Alternatively, users on the hub and spoke tenants can request to join.

Feedback

Was this page helpful?