Polymedia turns any media URL into a native Craft asset. Paste a YouTube link, Spotify track, HLS stream, or local video file — Polymedia creates a lightweight .pmedia manifest in your existing volume. The result is a real Asset element: searchable, relatable, permission-gated, and eager-loadable like any other asset in Craft.

16 providers supported out of the box — YouTube, Vimeo, Mux, Spotify, HLS, DASH, TikTok, Wistia, JW Player, Twitch, Cloudflare Stream, Shaka, PeerTube, Video.js, plus native MP4/WebM and audio formats. Most are auto-detected from the URL. No configuration needed.

Front-end rendering is optional and customisable. When you do want player output, Polymedia renders standards-based <media-controller> markup powered by Media Chrome. No iframes, no embed codes, no JavaScript framework lock-in. Render with one Twig call — either through the craft.polymedia.* helpers or directly on the asset itself with asset.getPlayer(), asset.getPoster(), or asset.getData(). The children option lets you compose your own control bar.

The field type extends Assets, so you get everything Craft's relation system offers — min/max limits, element conditions, eager loading — plus provider filtering and per-placement poster overrides.

Key features:

  • CP modal for adding media URLs with auto-detection
  • Deterministic thumbnail derivation for YouTube, Vimeo, Mux, Cloudflare and Wistia
  • Related assets for posters, captions, subtitles and transcripts
  • VTT validation with automatic BOM stripping
  • Script loader with CDN, self-host, or bring-your-own-bundler modes
  • Signed URL warnings to prevent token leakage in public volumes
  • Asset index reconciler for orphaned manifests
  • Twig API in two styles — craft.polymedia.player(asset) helpers, or asset methods like asset.getPlayer(), asset.getPoster(), asset.getTracks(), asset.isPolymedia
Installation Instructions

To install this plugin, copy the command above to your terminal.

Reviews

This plugin doesn't have any reviews.

Active Installs
2
Version
1.1.0
License
MIT
Compatibility
Craft 5
Last release
May 7, 2026
Categories
Activity (30 days)
0
Closed Issues
0
Open Issues
0
Merged PRs
0
Open PRs