English (UK)
Log in
Home
Home
Technical Resources Centre
Need help with setting up Workplace, managing domains or other technical info? Look no further.
Getting started
Just launched Workplace and not sure what to do next? We've got everything you need right here.
Technical Resources
You don't have to be an IT genius to launch Workplace, but if you are then these technical resources are for you.
In-depth hubs
Our resource hubs will help you master some of Workplace's most popular features and embrace new ways of working.
Help Centre
Find step-by-step instructions and answers to frequently asked questions.
Setup guides
From adding a domain to inviting users, follow this step-by-step guide to set up your Workplace.
Domain Management
Find out why domain management matters - and how to do it properly.
Workplace Integrations
Discover how to bring all your tools together. Something missing? Learn how to build your own integrations.
Account Management
Keep your Workplace up to date by creating, maintaining or deactivating user accounts.
Authentication
Make sure you only give access to the right people by integrating with your current identity solutions.
IT Configuration
Learn how to keep Workplace running smoothly with info on networks, email whitelisting and domains.
Account Lifecycle
Understand the process of inviting members of your organisation to claim their accounts.
Security and Governance
Get the lowdown on how we keep your people and information safe on Workplace with added technical terminology.
Workplace API
Learn how you can automate and integrate your custom solutions with Workplace using our API.
Live Video resources
Looking to use Live Video to transform your Town Halls? This is the place to get tips, guides and practical insights.
Knowledge Library resources
Wish your intranet was a little more inspiring? Use these Knowledge Library resources to get started.
Working from Home with Workplace
So you've embraced remote work - now what? Stay on top of your game with these guides, videos and customer stories.
New rules of engagement
Turn hybrid teams into high-performing teams by learning more about the new rules of employee engagement.
Getting started
From launching Workplace to paying for it, learn more about those crucial first steps.
Using Workplace
This is where we reveal the hidden depths Workplace has to offer with tips and info on key features.
Managing Workplace
Got a specific question about managing content, data or employees? This is the place to ask it.
IT and Developer Support
Looking for answers to more technical questions about security, integration and the like? Start here.
Integrations
    Security
      Interactive Demo
        Customer stories
        Workplace for Good
          Pricing Plans
            ROI Calculator
              Events and Webinars
                E-books and Guides
                  Newsroom
                    Workplace One Partner Programme
                      Service and reseller partners
                        Ways to work
                          Workplace Toolkits
                            Workplace Academy
                              Support
                                Customer Communities
                                  What's new in Workplace
                                    English (UK)

                                    IT Configuration

                                    Be sure everything around IT works smoothly for Workplace.

                                    Overview

                                    Overview

                                    Workplace Live is the best way to interact with coworkers in real time: it enables you to produce and distribute videos to large audiences whether in the office or on the go.

                                    This guide explains the steps required to configure and start a Workplace Live via third party conferencing software or professional equipment, along with providing some technical tips and best practices to ensure your network environment is correctly configured for streaming when a large number of viewers is expected.

                                    Ways to start a Workplace Live

                                    Ways to start a Workplace Live

                                    There are three ways of starting a Workplace Live video. First option is to go Live straight from Workplace (using the Workplace website or Workplace mobile applications), second option is to stream via a conferencing app (e.g. Zoom), third option is using professional equipment via an encoder: some encoders are software applications on your computer, while others are stand-alone hardware.

                                    • Going Live straight from Workplace requires minimal setup and is a lightweight option to start a Live video in a few seconds. Read more in our Help center guide.
                                    • Consider going Live via a third party video-conferencing tool (e.g. Zoom) if you need advanced host controls or want to offer the familiarity of a conferencing solution your employees use daily.
                                    • When a single stream is broadcasted to a significantly large audience (hundreds or thousands of users, e.g. a town hall) professional equipment provides the best option in terms of reliability and video quality.

                                    If you plan to go Live with multiple presenters and are not going to use an encoder or a third party conferencing solution, Workplace provides a built-in multi-presenter Live functionality which enables you to start broadcast with multiple hosts, including speakers from outside your organization. This is accomplished without the use of any third-party software or additional hardware. Hosts are able to invite co-presenters, share content on their respective screens, and collectively answer Live Q&A.

                                    Start a Workplace Live using a third party conferencing tool

                                    Start a Workplace Live using a third party conferencing tool

                                    Given that each third party conferencing solution has created their own integration with Workplace Live, you'll need to follow their documentation in order to complete the required setup before hosting your first Live.

                                    Zoom
                                    WebEx
                                    BlueJeans
                                    Start a Workplace Live using professional equipment

                                    Start a Workplace Live using professional equipment

                                    Workplace allows you to stream using a wide range of streaming solutions (i.e. encoders), both software and hardware. Most streaming software solutions have similar settings that need to be configured before going live. All other things being equal, hardware encoders tend to be more reliable and deliver higher quality results.

                                    To start a Live video with a professional equipment follow the steps below:

                                    1
                                    Go to the group or to the event where you would like to share the video and click on the post composer.

                                    2
                                    Click ... (More) > Live Video if you are streaming from a group. Click Live Video on the post composer, if you are streaming from an event page. The Workplace Live producer page will open.

                                    3
                                    Add a title, description and confirm the group or event where you’re planning to go Live. Choose whether your broadcast should include a Q&A, automatic captions or live rewind.

                                    4
                                    When everything is properly configured click Continue.

                                    5
                                    On the next screen, click Advanced Settings.

                                    6
                                    Scroll down to the Stream functional tabs. Select the Stream setup tab.

                                    7
                                    Copy-paste the Workplace-generated Server URL and Stream Key in your encoder and ensure encoder settings are matching our technical specifications. Please also read carefully our Advanced tips for high-stakes events, which include several indications on best practices you should consider at this stage.

                                    8
                                    After you're done, start streaming from your encoder. The steps to configure and start broadcasting vary by encoder, so read your encoder's documentation for instructions.

                                    9
                                    The Go Live button will become enabled when Workplace begins receiving video from your encoder. Configure Live settings (from the Setup options or Settings tab) and click the Go Live button to start your broadcast. Use Schedule a Live if you are preparing for a future broadcast.

                                    10
                                    When your event is done, click End Live Video to stop broadcasting.
                                    ?
                                    If the Go Live button is not enabled, Workplace is not receiving video from your encoder. Check your encoder's configuration and make sure you have started streaming.
                                    ?
                                    Workplace Live video broadcasts require RTMPS, the encrypted and secure variant of RTMP (Real-Time Messaging Protocol). Most recent versions of popular encoders already support RTMPS but you should check to be sure you are using RTMPS. If you are not using RTMPS, your streams will not work.
                                    ?
                                    Playback of live content will only work if the input broadcast has both an audio and a video track. Audio-only or Video-only broadcasts are not supported.
                                    Technical Specifications

                                    Technical Specifications

                                    To ensure premium quality live streams, please follow our technical specifications and streaming recommendations:

                                    Video Format

                                    • Maximum video resolution is 720p (1280x720) at 30 frames per second, with 1 key frame every 2 seconds.
                                    • You must send an i-frame (keyframe) at least once every two seconds throughout the stream.
                                    • Recommended max bit rate is 4 Mbps. Going above this maximum is possible but will make live streams highly unstable.
                                    • Changing resolution midstream has negative impact on the broadcast.
                                    • Titles must be less than 255 characters otherwise the stream will fail.
                                    • Live API accepts H264 encoded video and AAC encoded audio only.

                                    Video Length

                                    • 8 hour maximum length (via RTMP/S ingest or via app).
                                    • 4 hour maximum length for preview streams (either through Live dialog or publisher tools). After 240 minutes, a new stream key must be generated.
                                    • RTMP/S stream URLs will expire 24 hours after they are created.

                                    Advanced Audio Settings

                                    • Audio Sample Rate: 48 KHz
                                    • Audio Bitrate: 128 Kbps mono
                                    • Audio Codec: AAC

                                    Advanced Video Settings

                                    • Pixel Aspect Ratio: Square
                                    • Frame Types: Progressive Scan
                                    • Bitrate Encoding: CBR
                                    • Video Codec: H264

                                    Time Constraints

                                    • Stream keys are valid for 7 days.
                                    • Lives can only be scheduled up to 7 days in advance.
                                    Advanced Tips for High Stakes Events

                                    Advanced Tips for High Stakes Events

                                    Preparation and rehearsals are critical for success

                                    The single most important thing you can do is practice before your Live session. That will make things much smoother for you on the big day. The great majority of issues that can affect a Live success could be already mitigated in the preparation phase, hours if not days before a Live event is scheduled. Also remember, the more complex the setup, the more planning and testing is needed.

                                    • Do a dry run a day or two before the session.
                                    • Create a Workplace group that you can use to test your broadcast configuration safely.
                                    • Use the same assets (presentations, videos, etc.) that you're going to use on the day.
                                    • Everyone needs to rehearse. Leave as little to chance as you can.
                                    • Dim light will kill your video quality. Background noise or wind will make audio hard to understand. Make sure these elements are considered.
                                    • Test with the same peripherals that you’re going to use for the session.
                                    • If you can, invite a few other people to watch the rehearsal on their computers and mobile devices to make sure it's smooth for everyone.
                                    • Reach out to Workplace support in case you encounter any issues during tests: Please include ID of the Workplace Video and username of the users who has/have experienced the issue.

                                    Follow our encoding specifications precisely

                                    Always configure your encoder to send video and audio exactly as specified by Workplace. Review our technical specifications. Most encoder issues are the result of misconfiguration at this step.

                                    Consider setting up a back-up stream

                                    You can simultaneously stream a parallel backup Workplace live video to a Workplace live broadcast. If your primary stream fails, we will automatically switch to your backup stream so your live video broadcast can continue uninterrupted. Your broadcast will continue using the backup stream unless you manually switch back to the primary stream.

                                    To set up a back-up stream:

                                    1
                                    From the Advanced settings page in Live Producer, scroll down to the Stream functional tabs. Select the Stream setup tab.

                                    2
                                    Enable the Use a back-up stream option. A new stream key will be generated.

                                    3
                                    Copy-paste your stream key in a second encoder.

                                    We strongly recommend this setup for important events: best-practices include using a separate encoder, separate network and hardware for the back-up stream, different from those used for the primary broadcast, to increase fault tolerance.

                                    ?
                                    Please avoid generating two keys and using a single encoder as entering a new key while an encoder is still streaming will result in a Live drop off.

                                    Confirm you have a reliable internet connection is essential

                                    A stable connection for who goes Live is necessary to avoid the stream freezing or dropping off:

                                    • We recommend using wired connections whenever possible.
                                    • You should have 8-10 Mbps sustained and dedicated upload capacity. There are many online speed tests available or utilities.
                                    • If you must use Wi-Fi, make sure it’s secured and dedicated for the broadcast.
                                    • Ensure you are not connected to VPNs or proxies, or anything that can affect network performance (e.g. firewalls blocking Live traffic). If you have to whitelist Workplace endpoints in your network check our Network configuration article.

                                    We strongly recommend to ensure that all the requirements above are met. If you still have concerns about your internet quality, ensure your stream isn’t configured to end in case of an interruption. In case your stream goes dry, we’ll keep the Live stream going for a few minutes to allow your systems to reconnect before terminating it.

                                    To enable this option:

                                    1
                                    From the Advanced settings page in Live Producer, scroll down to the Stream functional tabs. Select the Stream setup tab.

                                    2
                                    Disable the End live video if stream stops option.

                                    Generate a local copy of the broadcast

                                    Always be prepared in the worst possible case. If Live can’t be recovered in case of interruptions, configure your encoder to generate a local copy of the Live session, so you can keep the broadcast going and upload a local recording once the event has finished. This will be visible on Workplace natively and viewers can comment, like and share. Not as good as Live but better than missing it altogether.

                                    ?
                                    It's always a good idea to check the Workplace status page before you begin.
                                    Troubleshooting

                                    Troubleshooting

                                    Due to the complex nature of live streaming, often times there may be issues along the way that prevent you from going live. Below are some common issues that you may face and how to address them:

                                    How do I check if my Live is going fine from a technical standpoint?

                                    The Stream Health tab in Live Producer includes time series views of key health metrics. Any drop in metrics may result in signal loss for some of your viewers and can help you anticipate and/or react to any issues with your stream.

                                    To access the Stream Health tab, once you’ve initiated your Live stream, scroll down from the preview screen to see it. If you are using an encoder we recommend also checking encoder logs and compare the data across these two sources.

                                    What does this error code mean in the Stream Health tab?

                                    If you have received an error in Stream Health tab, be sure to check our list of error codes to best understand the issue or reach out to Workplace support.

                                    What if a single user reports an issue while watching the stream?

                                    If a single user is reporting an issue while watching the stream, this is likely a problem for the single user, please ask them to refresh the page or use a different network.

                                    What if multiple users connected from the same network or using the same setup report an issue while watching the stream (e.g. low stream quality)?

                                    If this happens, this can be a specific issue with the shared settings e.g. using an outdated browser version or network link is saturated due to multiple connections.

                                    What happens if multiple users using different devices or connected from different networks are reporting they are experiencing distorted sound or low video quality?

                                    If you are using external cameras or microphones, go to the source: there may be a problem with the quality from connected sources. Check with your source providers or on their instructions how you can adjust camera or microphone settings in real time. If you’re experiencing no sound, check that your microphone isn't on mute.

                                    In second place, verify if any warnings or errors are being displayed in the Stream Health tab. If you see a drop in audio/video bitrate or frame rate, this is likely due to a weak internet connection, high CPU usage on your computer or misconfigured encoders. Try closing other open apps, disable browser extensions, VPN or firewalls, stop other network-intensive apps in your network or review your encoder settings, etc.

                                    The audio on my Workplace Live video has either begun to skip and chatter or drop out completely. What's going on?

                                    Audio distortion can occur when Workplace receives a video stream with distorted audio or after we've received the frames but before we re-encode for broadcast. A possible reason for this type of error is if the bitrate used is higher than the connection between your broadcasting endpoint and what Facebook servers can sustain. If that happens or if there's a packet lost, some of the video or audio track won't be received correctly and result in audio distortion.

                                    Why are the video and audio out of sync on my live video?

                                    A/V sync issues may occur when a live broadcast is delivered with limited bandwidth to the client, or the client does not have the bandwidth to view it during live. Additionally, if the stream received by the Facebook server is out of sync, then the live video will also be out of sync. Be sure to check recording and encoding hardware for potential places in which the audio could be misaligned with the video.

                                    I'm trying steam video without audio. Why doesn't it work?

                                    A Workplace Live requires audio. It you attempt to stream video only, the stream ends.

                                    What happens if my live feed drops?

                                    Your live feed may drop due to an encoder failure or poor network connectivity. If this happens, you have 2-3 minutes to reconnect to the original stream URL that you generated for your live post. Otherwise, you will have to generate a new stream key and URL to continue your live stream.

                                    My Workplace live video is still showing up as is Live even though it should have ended.

                                    If the broadcast still appears as ‘is Live’ after signaling the end of your live stream, make sure you've clicked End Live Video. If that’s the case, Workplace will automatically terminate the broadcast after a couple of minutes without receiving any signal. If the problem recurs, please contact our support team and include your video ID.

                                    I’ve tried all the above and I’m still having issues with Workplace Live. What can I do?

                                    If you are still experiencing issues with a Live stream, check the Workplace Status page and contact our support teams. Please include the video URL, details of the user or the users who were Live, the group where the Live is/was happening and if you encountered any similar issues during the rehearsal.