About integration

Viva Goals integration lets you link your OKRs to boards for automatic real-time updates on your objectives.

For example, if you have an objective to "Become the market leader," you can directly link this objective with the relevant items on a board on Whenever there's an update in the status of items on, your OKR status will automatically get updated.

All users and admins can use the integration. Admins also have permissions to manage the integration from the admin dashboard.

How to install the Viva Goals app for

Before you set up the integration connection, reach out to your administrator to install the Viva Goals app by using this link.

Connect to your Viva Goals account from the admin dashboard

  1. The first step to set up the integration is to connect your account to Viva Goals. From the sidebar, select Admin and then Integrations.

    Screenshot of the integrations page in Viva Goals.

  2. In the Integrations section, go to and then select Manage.

    Screenshot shows where you choose to manage in Viva Goals.

  3. Select New Connection. In the pop-up dialog, sign in to your account.

    Screenshot shows where you choose to create a new connection for in Viva goals.

  4. Name your connection, and then select Next to complete new account setup.

    Screenshot shows where you name your new connection.

How to edit an existing connection

Admins can also edit an existing connection, including the integration’s name and any shared state that you created, from the integration view:

  1. Start in the Integrations section in the Admin Dashboard. Select

  2. Select the Edit icon next to the connection. In the pop-up dialog box that appears, you can edit the connection's name or clear the Share connection with all users checkbox.

How to use the integration

After the integration is set up, you can connect your Viva Goals OKRs with a corresponding board in to measure your OKR progress:

  1. Go to the OKR of your choice. In the Progress section, select the Automatically from a data source option.

  2. Select from the list of integrations available. If multiple connections are already listed, choose the connection you want to use or create a new one.

    Screenshot shows where you select as the data source to update progress.

  3. Select the board, group, and assignee you want to connect to, and map the status column based on which OKR progress should be tracked to.

    Screenshot shows where you specify connection details for an OKR.

  4. Select Next to finish and save your OKR. You'll now see the icon next to the OKR's progress indicator, which means Viva Goals will automatically measure the progress based on item updates in the corresponding board in


    • If an item in your has status indicated only by color but no labels, Viva Goals will consider that item incomplete even though the specific color is considered as done in the board column settings.
    • If a doesn't have the default completion status, items that have status as Done will be considered complete.
    • The assignee field in Viva Goals will be mapped to the Owner field in by default. You can also search and add assignees to list their items. The Preview option will show the total number of items that remain and that are completed. For KPI-based OKRs, the Preview option will just show the total number of items available in the mapped board.
    • Viva Goals will sync data from hourly.

How to disable integration

An admin can disable the integration at any time:

  1. Go to In the Integrations section, select Manage.

  2. On the configurations page, select the Change dropdown, select Disable and confirm.

    Screenshot shows how to disable in Viva Goals.