Set up and use Whiteboard to Whiteboard collaboration (Surface Hub)

The Microsoft Whiteboard app includes the capability for two Surface Hubs to collaborate in real time on the same board.


A new Microsoft Whiteboard app was released on July 12, 2018. The existing Whiteboard app that comes installed on Surface Hub and is pinned to the Welcome screen cannot collaborate with the new version that can be installed on the PC. If people in your organization install the new Whiteboard on their PCs, you must install the new Whiteboard on Surface Hub to enable collaboration. To learn more about installing the new Whiteboard on your Surface Hub, see Whiteboard on Surface Hub opt-in.

By ensuring that your organization meets the prerequisites, users can then ink, collaborate, and ideate together.

example of a whiteboard with collaborative inking

Prerequisites for Whiteboard to Whiteboard collaboration

To get Whiteboard to Whiteboard collaboration up and running, you’ll need to make sure your organization meets the following requirements:

  • Office 365 with cloud-based Azure Active Directory (Azure AD) for all users
  • OneDrive for Business deployed for all users who intend to collaborate
  • Currently not utilizing Office 365 Germany or Office 365 operated by 21Vianet
  • Surface Hub needs to be updated to Windows 10, version 1607 or newer
  • Port 443 needs to be open since Whiteboard makes standard https requests
  •,, *, and your company's SharePoint tenant domain URLs need to be whitelisted for proxies


Collaborative sessions can only take place between users within the same tenant, so users outside of your organization won’t be able to join even if they have a Surface Hub.

Using Whiteboard to Whiteboard collaboration

To start a collaboration session:

  1. In the Whiteboard app, tap the Sign in button.
  2. Sign in with your organization ID.
  3. Tap the Invite button next to your name at the top of the app.
  4. Tap Start session. Whiteboard will generate a link that you can share.

    screenshot of the link dialog box on whiteboard

  5. Copy and paste this link into a Skype chat with another Surface Hub

When the other Surface Hub receives the link, the recipient can tap on the link, sign in to Whiteboard, and then begin collaborating. You can copy and paste other content, use smart ink features like Ink to Shape, and co-author together.

After you’re done, you can export a copy of the Whiteboard collaboration for yourself through the Share charm and leave the board for others to continue working.


When you start a collaboration session, Whiteboard creates a folder named Whiteboard App Data in your OneDrive for Business to store your shared whiteboards. After some collaboration sessions, this folder may continue to sync or process changes indefinitely. You can fix this by choosing to not sync the Whiteboard App Data folder to your device. Disabling sync for this folder won't limit your ability to use Whiteboard for collaboration sessions.