From ddfd1f1d6a931cb19d14dbe1b6249a2abab13968 Mon Sep 17 00:00:00 2001
From: Renzo Delfino <75499398+R-Delfino95@users.noreply.github.com>
Date: Sun, 10 May 2026 21:51:18 -0300
Subject: [PATCH] docs(site): warn that bundled HTML installs need
 type="module" (#1530)

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 site/src/content/docs/how-to/installation.mdx | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/site/src/content/docs/how-to/installation.mdx b/site/src/content/docs/how-to/installation.mdx
index de6ae7ce..67e1590c 100644
--- a/site/src/content/docs/how-to/installation.mdx
+++ b/site/src/content/docs/how-to/installation.mdx
@@ -127,6 +127,16 @@ Video.js supports a wide range of file types and hosting services. It's easy to
 <ContentWidth>
   <HTMLUsageCodeBlock client:idle />
 </ContentWidth>
+
+<Aside type="caution" title="Load your script as a module">
+When using a bundler (npm, pnpm, yarn, bun), load the resulting bundle with `type="module"`:
+
+```html
+<script type="module" src="/dist/player.js"></script>
+```
+
+Some bundlers default to an IIFE output format. Loading that bundle without `type="module"` will cause a `StoreError: NO_TARGET` error when interacting with the player. The CDN install path already uses `type="module"` — bundled installs need the same.
+</Aside>
 </FrameworkCase>
 
 <FrameworkCase frameworks={["react"]}>