Media Player (Video.js)Updated
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.

Adding a player#
- Click + Add Link and type a label. The label becomes the player title.
- Click the Link style button and choose Media player (video or audio).
- Set Media type to Video or Audio.
- Paste the Source URL, or click Pick from media to choose a file from your Media Library.
- For video, optionally add a Poster image.
- Click Update.

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.

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.

Cookie consent and videos that can’t play#
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.

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.