Add Viva Connections for Microsoft Teams desktop

Microsoft Viva Connections - one of the four Viva modules - is your gateway to a modern employee experience. The Viva Connections for desktop experience, formerly known as the Home site app, combines the power of your intelligent SharePoint intranet with chat and collaboration tools in Microsoft Teams. Viva Connections enables users to discover and search relevant content, sites, and news from across the organization right from the Team’s app bar. Viva Connections also allows you to incorporate your organization’s brand and identity directly in Teams.

Benefits of using Viva Connections

Image of the SharePoint home site in Teams

  1. Highlight specific resources: Viva Connections uses the company-curated global navigation links along with personalized content like sites and news, which are powered by Microsoft Graph. Global navigation is configured in SharePoint and can be accessed by selecting the icon in Teams app bar.

  2. Navigate intranet resources in Teams: Navigate to all modern SharePoint sites, pages, and news within Teams without losing context. All files will open in the Teams file preview window.

  3. Search for intranet content in Teams: On the home page, you can search for intranet content in SharePoint by searching in the Teams search bar. Search results will be displayed on a SharePoint site in the browser.

Image of a search on the home site in Teams

  1. Share content easily: Features in the SharePoint site header will dynamically display tools that help users collaborate depending on the type of content being viewed. Tasks such as sharing a link to a SharePoint page in a Teams chat are much easier.

Important

  • You need SharePoint admin permissions (or higher) to create the Viva Connections for Teams desktop app in PowerShell, and you need Teams admin permissions (or higher) to apply the app in the Teams Admin Center.
  • Viva Connections for desktop is not yet supported in the Teams mobile app.
  • Only modern SharePoint sites and pages can be viewed in Teams and all other content will open in a browser.
  • Global navigation menu links can be audience targeted so that specific content is surfaced to certain groups of people. Audience targeting settings in the SharePoint global navigation menu will carry over to global navigation in Teams.
  • Search customizations applied to SharePoint sites will apply to search results in Teams when on the home site. All SharePoint out-of-the-box site headers are compatible with Viva Connections desktop. However, if you modify your SharePoint site to remove, or significantly change the site header, then these contextual actions may not be available to the user.
  • Viva Connections was originally announced as the Home site app.
  • Viva Connections for mobile will become available in Summer 2020 and will include enhancements to the overall configuration and deployment experience.
  • The Viva Connections for desktop PowerShell script is available now in the Microsoft download center.

Watch how to create the app package and then upload it to Teams

Prepare for Viva Connections

The first version of Viva Connections can be provisioned through PowerShell and then will be uploaded as an app in the Teams Admin Center. The PowerShell script will be available at the end of March. Future versions of Viva Connections will be automatically available through the Teams Admin Center. Prepare your organization for Viva Connections now, or in the near future, by reviewing the following requirements and recommendations:

Image of global navigation icon in the Teams app bar

Viva Connections requirements:

  • Global navigation is enabled in SharePoint - It is recommended that global navigation is enabled and customized in the SharePoint app bar so that SharePoint resources appear in Teams.

Viva Connections recommendations:

Step-by-step guide to setting up Viva Connections desktop

Complete the following steps to enable Viva Connections desktop using SharePoint PowerShell:

  1. Set up a SharePoint home site: We highly recommend that you set up a SharePoint home site and use that site as the default landing experience for your users in Teams.

  2. Enable global navigation and customize navigational links: Set up and customize global navigation in the SharePoint app bar. Learn about the different ways you can set up the home site navigation and global navigation to surface the right content at the right time.

  3. Create a Viva Connections app package in PowerShell: The SharePoint admin needs to download and run PowerShell script from the Microsoft download center to create the Viva Connections desktop package. Ensure that you are using the latest version of the SharePoint Management Shell tool before running the script.

Important

  • The Viva Connections for desktop PowerShell script is available now.
  • SharePoint admin credentials are required to use SharePoint PowerShell.
  • The SharePoint admin who creates the Viva Connections desktop package needs site owner permissions (or higher) to the home site in SharePoint.
  • If your tenant is using an older version of PowerShell, uninstall the older version and replace it with the most up to date version.
  1. Provide tenant and site information to create the package: Download the Viva Connections for desktop PowerShell script and provide the information below.

When you create a new package in PowerShell, you will be required to complete the following fields:

  • URL of your tenant’s home site: Provide the tenant's home site URL starting with "https://". This site will become the default landing experience for Viva Connections.

  • Provide the following details when requested:

    • Name: The name of your Viva Connections desktop package, as it should appear in Teams app bar.
    • App short description (80 characters): A short description for your app, which will appear in Teams app catalog.
    • App long description (4000 characters): A long description for your app, which will appear in Teams app catalog.
    • Privacy policy: The privacy policy for custom Teams apps in your organization (needs to start with https://). If you do not have a separate privacy policy, press Enter and the script will use the default SharePoint privacy policy from Microsoft.
    • Terms of use: The terms of use for custom Teams apps in your organization (needs to start with https://). If you do not have separate terms of use, press Enter and the script will use the default SharePoint terms of use from Microsoft.
    • Company name: Your organization name that will be visible on the app page in Teams app catalog in “Created By” section.
    • Company website: Your company’s public website (needs to start with https://) that will be linked to your company’s app name on the app page in Teams app catalog in “Created By” section.
    • Icons: You are required to provided two PNG icons, which will be used to represent your Viva Connections desktop app in Teams; a 192X192 pixel colored icon for Teams app catalog and a 32X32 pixel monochrome icon for Teams app bar. Learn more about Teams icon guidelines.

Note

Microsoft does not have access to any information provided by you while running this script.

  1. Upload the Viva Connections desktop package in the Teams Admin Center: Once you successfully provide the details, a Teams app manifest, which is a .zip file, will be created and saved on your device. The Teams administrator of your tenant will then need to upload this app manifest to Teams admin center > Manage apps.

    Learn more about how to upload custom apps in Teams admin center.

  2. Manage and pin the app by default for your users: Once the Viva Connections desktop package is successfully uploaded in the Teams admin center, it can be managed like any other app. You can configure user permissions to make this app available to the right set of users. Permitted users can then find this app in Teams app catalog.

    We highly recommend that you pin this app by default for users in your tenant so that they can easily access their company’s intranet resources without having to discover the app in Teams app catalog. Use Teams app setup policies to pin this app by default in Teams app bar and then apply this policy to a batch of users.

Then, onboard end users for Viva Connections

Help end users understand how to use Viva Connections to improve workplace communication and collaboration.

FAQs

Q: Can any site be pinned as default landing experience in Teams?

A: Modern SharePoint communication sites are eligible for pinning in Teams via Viva Connections. However, we highly recommend that you nominate a home site in SharePoint and pin that as the default landing experience for your users in Teams.

Q: Can my classic SharePoint site be pinned in Teams?

A: No, classic SharePoint sites are not supported in Microsoft Teams.

Q: Do I need Viva Connections for the global navigation to show up in Teams?

A: Yes, the global navigation menu links are stored in the home site of a tenant, and is required in order for the navigation panel to appear in Viva Connections in Teams. Learn more about how to enable and set up global navigation in the SharePoint app bar.

Q: What happens if I don’t configure global navigation links before setting up Viva Connections?

A: The user will still be able to access followed sites and recommended news by selecting the global navigation icon in Teams but will not have direct access to intranet navigational items.

Q: What is the difference between using Viva Connections and adding a SharePoint page as a tab in Microsoft Teams?

A: Viva Connections allows organizations to pin an organization-branded entry point to their intranet that creates an immersive experience, complete with navigation, megamenus, and support for tenant-wide search. Viva Connections also provides quick access to organization curated resources, followed sites, and news like those provided by the SharePoint app. SharePoint pages can be pinned as tabs in Teams channels provide ways to bring content directly into Team collaboration workspace, and these pages do not feature navigation and search elements.

Q: Is this the same feature that was announced in fall 2020 as the Home site app?

A: Viva Connections was originally announced as the Home site app but will be called Viva Connections moving forward.

Q: When will Viva Connections for mobile become available?

A: Following on our spring release of the desktop experience for Viva Connections, we are rolling out an update that includes native mobile experiences for Teams on iOS and Android, enhancements to the overall IT configuration and deployment experience for the combined desktop and mobile app, as well as new Dashboard and Feed web parts for the desktop to complement the experience.

More resources

Set up a home site for your organization

Enable and set up global navigation in the SharePoint app bar

Introduction to SharePoint Online Management Shell

Learn more about Microsoft Viva

Learn more about Viva Connections