Docs

Media Player (Video.js)Updated

4 min readUpdated November 10, 2026

The Media player (video or audio) style puts a player right on the bio page. It plays your own video and audio files, HLS streams (including Bunny Stream), YouTube and Vimeo, with controls in your theme’s accent colour.

The player is built on Video.js 10. Before version 1.0.7 it used Vidstack, which is now deprecated in favor of Video.js; existing player links switched over automatically with no changes needed.

The video player on a bio page with poster image

Adding a player#

  1. Click + Add Link and type a label. The label becomes the player title.
  2. Click the Link style button and choose Media player (video or audio).
  3. Set Media type to Video or Audio.
  4. Paste the Source URL, or click Pick from media to choose a file from your Media Library.
  5. For video, optionally add a Poster image.
  6. Click Update.
Media player settings with media type, source URL and poster image

The URL field at the top of the link row is optional for players; the player itself is what visitors use.

Fields#

Media type: Video shows a 16:9 player. Audio shows a compact bar. Picking a file from the Media Library sets this for you.

Source URL: what to play. The right player loads for the address you paste:

Source Example Plays as
Video file .mp4, .webm Video
Audio file .mp3, .m4a, .ogg, .wav Audio
HLS stream ends in .m3u8 Video or audio, by Media type
Bunny Stream https://vz-xxxx.b-cdn.net/<video-id>/playlist.m3u8 HLS video
YouTube watch, youtu.be, Shorts or playlist links Video
Vimeo vimeo.com/123456789 Video

Poster image (optional): the picture shown before a video plays. Click Pick or paste an image URL. For YouTube and Vimeo without a poster, the video’s own thumbnail is used.

How each source plays#

  • Files and HLS streams play in the Video.js player. HLS uses hls.js, loaded only on pages with a stream.
  • YouTube plays from youtube-nocookie.com, asks for HD quality once playback starts, and keeps a ?t= start time from your link.
  • Vimeo plays with Do Not Track turned on.
  • Each bio page loads only the player code its links need.
  • YouTube and Vimeo players load when they come near the screen, not when the page opens.
  • Before a video plays, the player shows only its cover image with one play button in the middle. The cover comes back when the video ends.
  • Pressing play before YouTube has finished loading is fine: the player keeps asking until YouTube is ready, so it never keeps spinning.
  • No YouTube or Vimeo branding over the video: YouTube’s title bar, channel logo and “More videos” panel stay out of view when the video is paused, the cover image comes back at the end instead of YouTube’s end screen, and Vimeo’s title, byline, portrait and badge are hidden.
The audio player on a bio page

Bunny Stream#

Paste the HLS playlist URL of the video from your Bunny Stream library. It ends in playlist.m3u8, for example https://vz-a1b2c3d4-e5f.b-cdn.net/<video-id>/playlist.m3u8.

  • Without token authentication on the library, the URL plays as is.
  • With token authentication, add the library’s CDN token key at Link Bio → Settings → Bunny Stream. WP LinkCanvas then signs Bunny playlist URLs fresh on every page view, so they never expire. This includes URLs you pasted already signed (with bcdn_token= in them): they are re-signed with a new expiry. On pages served from a page cache, the player asks for a fresh signed address each time the page opens, so the video keeps playing however old the cached page is.

Without the key, a signed URL you paste keeps working only until the expiry Bunny gave it.

The optional Bunny Stream CDN token key setting

Some cookie tools block YouTube and Vimeo until the visitor agrees. With Must-Have Cookie, a blocked player shows a short message with Must-Have Cookie’s own buttons instead of a player that can never start:

  • Accept and play records the consent in Must-Have Cookie, and the video plays.
  • Cookie settings opens Must-Have Cookie’s settings.

You can change these buttons under Link Bio → Settings → Media player → Consent buttons. To skip the consent step, choose Always allow YouTube and Vimeo in the same place. See Must-Have Cookie for both options.

If a video still can’t start, for example because a browser extension blocks it, the player says This video could not be loaded and offers Try again. A YouTube video whose owner does not allow it on other websites shows Watch on YouTube instead.

The browser console shows a [WP LinkCanvas video] line naming the step a stuck video reached, which helps when asking for support.

Player colours#

The play button and progress bar use the theme’s accent colour, and the player’s corners follow the theme. In a Custom theme you can set them separately under Player colors: Player accent and Player corner radius. Click Auto to go back to the theme’s values. See Custom Theme Builder.

Player colors in the Custom theme builder: player accent and corner radius, each with an Auto button

On phones#

Players play inline (they do not jump to full screen on their own), and the full-screen button is in the controls.

Toolbar#

Geo targeting, schedule, sensitive content gate, show/hide and remove all work on players. See Button Links.

This website uses cookies to enhance your browsing experience and ensure the site functions properly. By continuing to use this site, you acknowledge and accept our use of cookies.

Accept All Accept Required Only