Sharing to Workplace

If you have content that exists outside of Workplace, you may want to make it simple for people to share that content back into Workplace, so that others can find it, or to start a discussion in a Workplace group.

Workplace supports several ways to share content from apps or websites, including the Workplace Share Dialog for web and Workplace Share Extension on mobile.

Sharing via Workplace Share Dialog

To share web-based content to Workplace, for example content hosted on an intranet site, you can provide a button that launches the Workplace Share Dialog. This dialog allows you to share content to a Workplace group, to your Workplace profile, or to a person or group of people via a Work Chat message.

The Workplace Share Dialog can be launched in a new tab or in a browser popup window, and requires a parameter for the URL of the object you're sharing. The Workplace Share Dialog assumes an active Workplace session. It can be invoked via the generic subdomain work.facebook.com, but will immediately redirect to the active user's company subdomain.

Under the hood, the Workplace Share Dialog inherits from the Facebook Share Dialog, so much of the functionality is identical. Unlike the Facebook Share Dialog, an app ID cannot be passed to the Workplace Share Dialog.

Launching the Share Dialog via Javascript

You can launch the dialog by placing a button on your UI and adding a JavaScript handler that uses window.open to launch a new window. For example:

<button onclick="share()">Share to Workplace</button>
<script>
share = function(){
    url = 'https://work.facebook.com/sharer.php?display=popup&u=' + window.location.href;
    options = 'toolbar=0,status=0,resizable=1,width=626,height=436';
    window.open(url,'sharer',options);
}
</script>

You can launch the dialog directly via a HTML hyperlink if you can provide the URL at render time. For example:

<a href="https://work.facebook.com/sharer.php?display=page&u=https://developers.facebook.com" target="_blank">
    Share to Workplace
</a>

Workplace Share Dialog Parameters

The Workplace Share Dialog takes the following parameters:

ParameterRequiredDescription

u

Yes

The URL to be shared

display

No

The preferred display method for the dialog:

  • If launching via a Javascript window.open call, use display=popup
  • If launching via a link, use display=page

redirect_uri

No

If you're launching the dialog via display=page, you can ensure people return to your site by providing a redirect URI back to where they were before launching the dialog.

Sharing from Mobile Apps

When the Workplace app is installed on mobile device, a new share dialog will be made available to apps that support sharing via Share Extensions (iOS) or Share Intents (Android). Many enterprise apps already support this method of sharing, so it should be possible to share directly to Workplace from these apps.

Link Previews

When you pass a URL to Workplace, the Facebook share scraper will attempt to render a preview, based on the metadata information it can 'scrape' from the link. If your links aren't public to the world, Facebook's scraper will not be able to get the metadata it needs, and Workplace will be unable to render a preview.

See the dialog parameters for details of the available parameters on the Workplace Share Dialog for web.