Viva Engage widgets

This page is about the Viva Engage widgets included into Elementi 2025 and later versions. For the previous implementation, see Yammer widgets.

Introduction

The Viva Engage widgets are digital components designed to display posts and conversations from Microsoft Viva Engage (formerly Yammer). These widgets can be integrated into digital signage projects to improve internal communication and employee engagement.

Use cases:

Corporate communications: Share company-wide messages and updates.
Leadership messages: Highlight posts from executives or leadership teams.
Community engagement: Display updates from internal communities or groups.

Requirements

Elementi 2025 or later.
The designated players must run at least DSOS 4.8.4, preferably the latest DSOS version.
A Microsoft Office 365 account with access to Viva Engage.

Secure data access

Access to Viva Engage data is performed using the “Connectors” service. This modern approach replaces the legacy Cockpit Channels service (Yammer), providing a more flexible and robust integration.

See step-by-step instructions for adding a Microsoft 365 connector.

Get started

Click the "Projects" tab in the Browse panel.
Create a new Elementi project or open an existing one. Make sure your project is linked to a SpinetiX cloud account.
The project's main index file is opened by default. If needed, open the file that should contain the widget.
Click the "Widgets" tab in the Browse panel to find all the collections of widgets included with your Elementi version/type.
Elementi 2025 X widgets
Double-click the "Viva Engage" collection and find the widgets delivered with Elementi.
Viva Engage widgets
Select the widget that best fits how you want to present the data.
Drag that widget from the Browse panel and drop it into the Edit panel (or the Preview panel) to create a new media layer within the opened document. The built-in widget is automatically copied into your project files.
Double-click the widget's layer in the Edit panel to find its properties.
Configure the widget's properties and layout to display your data.

Included in Elementi

Elementi software comes with several Viva Engage widgets accessible from the "Widgets" tab within the Browse panel:

Widget	Description
Single Post	Displays a single post per slide using a pre-formatted dark-blue design, typically including image content (or QR code if a link is promoted) on the right. The slides are displayed one after another, with or without a transition effect in between.
Multi Post	Displays multiple posts per slide using a pre-formatted design with alternating background colors per row. The slides are displayed one after another, with or without a transition effect in between.
Icon of Viva Engage Text Bar widget in Elementi. Text Bar	Displays text content using a fixed number of lines and applying a bottom-to-top & line-by-line scrolling effect whenever the entire text doesn't fit into the widget area.
Icon of Viva Engage Text Ticker widget in Elementi. Text Ticker	Displays text content using a continuous horizontal scrolling effect. The font size is adjusted automatically for the text to fit into the widget area.
Icon of Viva Engage Text Roll widget in Elementi. Text Roll	Displays text content using a continuous vertical scrolling effect. The font size is adjusted automatically for the selected number of lines to fit into the predefined area.
Icon of Viva Engage Slideshow widget in Elementi. Slideshow	Displays slides composed of text and media retrieved from Viva Engage. The slides are displayed one after another, with or without a transition effect in between, similarly to a playlist.
Icon of Viva Engage Horizontal Table widget in Elementi. Horizontal Table	Displays slides composed of structured layouts populated with Viva Engage data. The slides are displayed one after another, with or without a transition effect in between, similarly to a playlist. The Horizontal Table and Vertical Table widgets are simplified versions of the Table one in regards to the layout design.
Icon of Viva Engage Vertical Table widget in Elementi. Vertical Table
Icon of Viva Engage Table widget in Elementi. Table

Configuration

Widget properties

Viva Engage widgets - screenshot of the default logo content for unconfigured widgets.

All widgets show the Viva Engage logo in an unconfigured state. The customization options are found under the "Properties" tab. The only essential step is to click the button which opens the "Data Properties" dialog and set up the data source (explained below).

For more details about each widget, see:

Single Post widget configuration

**Viva Engage Single Post widget properties**

The following properties can be configured:

Data
Click the button to open the "Data Properties" dialog and set up the data source.
Locale
Select the locale used for displaying dates and numbers.
Slide duration
Enter the number of seconds each slide is displayed on the screen.
Transition
Click the button to open the "Transition Properties" dialog and select a transition effect and its properties.
Looping
Select whether the widget ends after the last slide or loops to the first one.
Call to Action
- Show
  Select whether the Viva Engage logo and the call-to-action text should be displayed.
- Text
  Edit the “Company news from Viva Engage” default text, appearing next to the Viva Engage logo.
Theme
Edit the advanced theme parameters (colors, font, etc.) in JSON format. Available only for Elementi X users.

Multi Post widget configuration

**Viva Engage Multi Post widget properties**

The following properties can be configured:

Data
Click the button to open the "Data Properties" dialog and set up the data source.
Locale
Select the locale used for displaying dates and numbers.
Slide duration
Enter the number of seconds each slide is displayed on the screen.
Transition
Click the button to open the "Transition Properties" dialog and select a transition effect and its properties.
Looping
Select whether the widget ends after the last slide or loops to the first one.
Number of rows
Enter the number of posts to display on a single slide.
Delay per cell
Enter the number of seconds to wait before displaying the next cell of the table.
Call to Action
- Show
  Select whether the Viva Engage logo and the call-to-action text should be displayed.
- Text
  Edit the “Company news from Viva Engage” default text, appearing after the Viva Engage logo.
Theme
Edit the advanced theme parameters (colors, font, etc.) in JSON format. Available only for Elementi X users.

Data source setup

“Data Properties” dialog for Viva Engage widgets.

To configure the data source, click the button. This opens the "Data Properties" dialog, which allows changing the following:

Account
Select or connect a Microsoft Viva Engage account.
Timeline
Select the data type filter, such as: “Home timeline”, “In Group”. Elementi X offers additional options: “Mentions of me”, “About Topic”, “Search”.

When selecting "In Group" or "About Topic", click the "Change..." button to search for the group/community or topic name in the popup dialog.
Max count
Number of posts to retrieve.
Refresh
Specify the period after which the widget should automatically refresh the feed data - this is useful when the widget is running in a loop.

Select one of the predefined options or enter a number, optionally followed by s (implicit), m or h, to specify the period after which the widget should refresh the feed data; the minimum accepted value is 60 seconds.

Select "When document opens" to get new data only when the widget is reopened by its parent document (like a playlist).
Hide replies
This option appears when setting the timeline to “In Group” or “Mentions of me”; enable it to prevent display the replies/comments to posts.

Tip:

Use the "Test..." button to verify that the data source configuration is correct.

Troubleshooting

Cloud account error: “This project uses connectors for a different account.”
This happens when opening a project linked to a SpinetiX cloud account (thus using the “Connectors” service) to which the currently logged-in user doesn't have access to. You need to request access to that account, or log off your current user and log in with another user having access to that cloud account.
Multiscreen usage
When creating multiscreen content for multiple players, these widgets can only be used on a single player. The alternative is to use an advanced data feed widget instead, which allows data feed synchronization.