Skip to main content

Embed with a Custom Player

By default, all embeds use the account default Player. You can override this on a per-embed basis to use any Player profile you have created.

Copy a Player-specific embed code from Viostream​

The easiest way to embed with a specific Player is to select it from within the Viostream embed dialogue:

  1. Navigate to the asset or channel you want to embed.
  2. Click Share, then open the Embed tab.
  3. Select your preferred Player from the Player dropdown.
  4. Click Copy Embed Code — the copied code will include your chosen Player.

Add a Player key to an existing embed​

If you already have embed code and want to switch the Player, add the playerKey attribute directly.

Find your Player key on the Embed Players tab in  Settings — it is displayed on each Player card (for example, s-abc123).

Iframe embed​

Add ?playerKey=YOUR_PLAYER_KEY to the src URL:

<div style="padding-bottom:56.25%; position:relative; display:block; width: 100%">
                <iframe
                  width="100%"
                  height="100%"
                  src="//play.viostream.com/iframe/nhedxonrxsyfee?playerKey=s-dmcqqw3"
                  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>

Script embed​

The Player key is included automatically when you copy embed code with a Player selected. If adding it manually, append ?playerKey=YOUR_PLAYER_KEY to the script src URL:

<script src="https://play.viostream.com/embed/nhedxonrxsyfee?playerKey=s-dmcqqw3"></script>