Documentation home
Player & publishing 8 min

Install the universal script or iframe

Use the universal script for normal websites and applications. Use the iframe when a builder or CMS only accepts contained iframe code.

Reviewed August 17, 2026

Browse documentation
1

Preferred: universal script

Place a marker wherever a video belongs and load `embed.js` once on the page. The runtime discovers multiple markers and dynamically inserted players.

Universal installation
<div
  data-sdv-video="ve_replace_me"
  style="display:block;width:100%;aspect-ratio:16/9;background:#020617;"
></div>
<script async src="https://embed.superdupervideos.com/v1/embed.js"></script>
2

Fallback: iframe

Use the iframe when the destination cannot run the universal script. It remains responsive and isolated, but a raw iframe cannot share as much page-level scheduling and runtime work as the universal install.

Iframe installation
<iframe
  data-sdv-frame="1"
  src="https://embed.superdupervideos.com/v1/frame/ve_replace_me?coordination=1"
  loading="lazy"
  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
  allowfullscreen
  style="width:100%;aspect-ratio:16/9;border:0;"
></iframe>
<script async src="https://embed.superdupervideos.com/v1/coordinator.js"></script>
3

Reserve the correct aspect ratio

Keep the wrapper or iframe width at 100% and declare the intended aspect ratio before playback loads. This prevents layout movement and gives the poster a stable rectangle.

4

Run the installation acceptance check

  • Poster-first layout at mobile and desktop widths
  • Play, seek, volume, quality, fullscreen, and keyboard controls
  • Approved-origin success and unlisted-origin denial
  • Two embeds and a dynamically inserted embed when the site needs them
  • The published production page rather than only a builder preview

Still looking for the missing step?

Browse the Help Center for concise answers, or send us the page and result you are trying to produce.

Keep going