Skip to main content

Embed a Live Stream

Every live stream has a permanent public key (for example, l-r68qhsn) that you use to embed it — the same way you embed any Viostream media asset. The public key never changes, so your embed code works across all sessions and continues to work after sessions end (serving the latest recording).

Find your public key​

Open your live stream in the Viostream console. The public key is shown in the Live Details section, next to the stream name.

Click the copy icon to copy it.

Embed in a Channel​

The recommended way to share a live stream is to add it as media in a Viostream Channel. This gives viewers a fully branded page with the live slate countdown before you go live.

  1. Open your Channel in the Viostream console.
  2. Navigate to the Content tab.
  3. Add your live stream using its public key.

See Managing Media in a Channel for full steps.

Direct embed (iframe or script)​

Use the standard Viostream embed code with your live stream's public key:

<div style="padding-bottom:56.25%; position:relative; display:block; width: 100%">
                <iframe
                  width="100%"
                  height="100%"
                  src="//play.viostream.com/iframe/nhedxonrxsyfee"
                  referrerpolicy="strict-origin-when-cross-origin"
                  allow="autoplay; encrypted-media; picture-in-picture"
                  allowfullscreen
                  frameborder="0"
                  style="position:absolute; top:0; left: 0">
                </iframe>
              </div>

Replace nhedxonrxsyfee with your live stream's public key.

For responsive and fixed-size embed options, see Embedding Responsive Videos.

What viewers see​

The embedded player is schedule-aware — it automatically displays the appropriate live slate based on your session schedule:

Viewer situationWhat they see
A session is upcomingCountdown timer to the next session
A session is active (you are live)Your live video
Session has ended, no upcoming sessionsSession ended message

Live slate messages are generated automatically. Custom branding for slates is available on request — contact Customer Success.

You can also share a direct link to your live stream using the Share button on the live stream detail page. This opens the stream on a Viostream-hosted share page.