Use a Viva Engage web part in SharePoint
Applies ToSharePoint Server Subscription Edition SharePoint Server 2019 SharePoint in Microsoft 365 Microsoft 365 admin SharePoint operated by 21Vianet

This article describes the Viva Engage Conversations and Viva Engage Highlights web parts that can be used to enhance collaboration on your modern SharePoint in Microsoft 365 page.

The Viva Engage Conversations web part has the latest new Viva Engage experiences including the ability to start a conversation with any type of post (questions, polls, praise) and mark best answers directly from SharePoint.

When you add conversations to internal sites like leadership, IT, HR, or communities, you help employees engage by asking questions, getting answers, and sharing best practices with each other.

What's new in the latest Conversations web part experience?

The new Conversations web part features multiple conversation types and a more interactive user experience including:

  • Updated look – The web part supports rich previews for media and visual treatment for questions, praise, and polls.

  • Viva Engage publisher functionality – When users create conversations, users have the following new features:

    • Create any type of Viva Engage post directly from SharePoint – questions, polls, praise, etc. 

    • Upload images and files into new conversations and replies directly from SharePoint

    • Use rich text in messages created from SharePoint.

  • Viva Engage manager actions – Community managers can use features like Close Conversation, Pin a Conversation, and Mark Best Answer to a Question.

    Improved, Relevant Home feed – Users can start a conversation in any community when configured to this mode.

  • Interactive web part length - The new experience is visually compelling and interactive. To bring in this rich Viva Engage conversation experience, the length of conversations in the web part and the height of the web part will most likely increase on pages. Site administrators can adjust the height of the web part to show fewer conversations on the page if the length becomes too long after the upgrade. The web part configuration supports as few as 2 conversations and a maximum of 12 conversations.

Conversations web part (the new Viva Engage experience)

Conversations web part experience - (the new Yammer experience)

Highlights experience

Highlights Classic experience

Highlights web part experience

Highlights web part Classic Yammer experience

Decide which web part to use

Here's how to choose which to use:

When to use it

What it does

Limitations

Viva Engage Conversations web part

Use this when you want users to participate in Viva Engage conversations without leaving your SharePoint page.

This experience brings the latest capabilities of Viva Engage to SharePoint.

For page users:

  • Shows conversations for a specific Viva Engage community, a specific topic, or all conversations that a specific person has participated in.

  • Participants can view the whole conversation and respond from the SharePoint page without needing to open Yammer.

  • Participants can start new conversations of all types (questions, polls, and praise) from SharePoint.

  • Participants can include gifs, files, and videos in new conversations and replies.

Participants can use conversation capabilities like closing conversations and marking best answers from SharePoint, depending on permissions.

For page authors:

  • Choose what to display based on search.

  • Choose how many conversations are displayed: 2, 4, 8 or 12.

  • Inherit the theme from the page.

  • You can't select a specific conversation to display.

  • You can’t display conversations horizontally.

  • You can’t configure to display specific conversations (curated conversations).

  • Only works on modern pages.

Viva Engage Highlights web part

Use this if it's the only Viva Engage web part available to you, or if you want to provide a quick overview of active conversations and a targeted portal to specific groups or conversations in Viva Engage.

For page users:

  • View the most recent message in the top or most recent conversations from a group.

  • View the most recent message in specific conversations.

  • Users can only view the first message in a conversation. To respond, the user must click a link to open Viva Engage.

  • Users cannot start conversations that are questions, polls, or praise.

  • Users cannot include gifs, files, or videos in new conversations or replies.

  • You can't display all conversations for a topic, or all topics that one user participates in. You can't display your home feed.

  • To specify a conversation, you need the URL of the conversation.

  • Only works on modern pages.

Highlights web part - Classic mode

Use this only if the Viva Engage Conversations web part is not yet available and you want users to be able to participate in Viva Engage conversations without leaving SharePoint.

For page users:

  • Shows messages and responses in conversations.

  • Shows many types of Viva Engage feeds.

  • Doesn't work for users who use a mobile device to view the page or who have third-party cookies disabled.

  • Doesn't inherit the theme of the SharePoint page.

  • To set this up, you must use Viva Engage to look up the web address of the specific group, person, or topic or of your Viva Engage Home feed.

  • Users may have to log in to Viva Engage even though they have already signed in to Microsoft 365.

Add a Viva Engage Conversations web part to a SharePoint modern page

  1. If you're not in edit mode already, select Edit at the top of the page.

  2. Hover above or below an existing web part or under the title region, select  Circled plus sign used to add a modern web part to a page, search for Viva Engage, and then select the Conversations web part.

  3. In Select conversation source, select one of the following:

    • Group: Displays the most recent conversations posted in the selected group.

      Note: If the selected community has a pinned conversation, the web part displays the maximum number of conversations plus the pinned conversation at the top.

    • User: Displays the most recent conversations that this user has participated in.

      Note: This mode does not display the Viva Engage publisher to start a new conversation

    • Topic: Displays the most recent conversations tagged with this topic.

      Note: This mode does not display the Viva Engage publisher to start a new conversation.

    • Feed: Displays the most recent conversations that show up for the user in Viva Engage when they select the Home button.

  4. In Search for a source, enter the name of the group, user, or topic.

  5. In Number of conversations to show, select 4, 6, or 8, based on how much room you want this web part to take up on your page.

After you've published the page, users can reply and follow the conversation from within your page.

Add a Viva Engage Highlights web part to a SharePoint modern page

  1. If you're not in edit mode already, click Edit at the top right of the page.

  2. Hover above or below an existing web part or under the title region, select  Circled plus sign used to add a modern web part to a page, search for Viva Engage, and then select the Viva Engage icon labeled either Viva Engage or Highlights.

  3. If you're adding the Viva Engage web part to a site that has an associated Viva Engage community or group, the Viva Engage group will be detected and added automatically. Otherwise, click Add a Group and use the search bar to find a group.

  4. Select one of the following conversation options:

    • Top Conversations: The group's most engaging conversations.

    • Latest Conversations: The group's most recent conversations that are new to the reader.

    • Only conversations you choose: This option requires you to go to Viva Engage to get the URLs for up to four conversations you want to displays.

After you've published your page, users can:

  • Create a new message in the group by selecting Post to Viva Engage.

  • Select the post to go to it in the Viva Engage community or group.

  • Select View more at the top of the web part to go to all of the posts in that Viva Engage community or group.

  • Like the post.

  • Add a comment below the post. Comments show up only on the page, and are not added to the Viva Engage conversation.

FAQ

Q: Can Viva Engage external users use the Yammer web part?

A: No. External users of any type will see an error message regardless of whether or not they are eligible to see the group in Viva Engage.

Known Limitations with the Conversations web part

  • On a Mac or iOS device, if you're using the Safari browser or the SharePoint iOS mobile app, when you look at a message that should have an image, you'll see Sorry there is a problem with this file.

    To work around this issue and see the image:

    • From Safari, in the Safari Settings page, disable Prevent Cross-Site Tracking. This allows images to be shown in the SharePoint web part.

    • From the SharePoint iOS app, in the SharePoint in Microsoft 365 pages, tap the error, and the image will open in the Viva Engage app (if it is installed on your device, or in the browser).

    • The Viva Engage Conversations web parts only work when the SharePoint site uses the original domain name, for example contoso.onmicrosoft.com. Conversation web parts aren't supported when the SharePoint site uses a vanity domain name.

    • Custom themes – The updated conversations web part supports all the in-box themes. Light themes show conversations on a white card background and dark themes show conversations on a grey card background. Some custom themes may experience issues due to the colors used. If your organization is experiencing issues with a custom theme, contact Microsoft Support.

  • While the Conversations web part with the new Viva Engage experience is being updated across networks, there is a known issue with the older Conversations web part experience. When you add the Conversations web part (if your network has not yet been upgraded to the new experience), the web part will show an error even after you finish configuring it. As a workaround, you can save the configuration and refresh the page to see the configured feed.

Known Limitations with the Highlights web part

  • The Viva Engage Highlights web parts only work when the SharePoint site uses the original domain name, for example contoso.onmicrosoft.com, and are not supported when the SharePoint site uses a vanity domain name.

  • The Viva Engage Highlights web part does not include the latest experiences from the new Viva Engage. For example:

    • You cannot create questions, polls, praise from the Highlights web part.

    • You cannot upload images and files into new conversations and replies from the Highlights web part.

    • You cannot use Viva Engage conversation-management actions: Close Conversation and Mark Best Answer to a Question.

      For these latest capabilities, we recommend using the Viva Engage Viva Conversations web part.

Need more help?

Want more options?

Explore subscription benefits, browse training courses, learn how to secure your device, and more.

Communities help you ask and answer questions, give feedback, and hear from experts with rich knowledge.