diff --git a/_extensions/quarto-ext/shinylive/shinylive.lua b/_extensions/quarto-ext/shinylive/shinylive.lua
index 6890a7a..a8ce817 100644
--- a/_extensions/quarto-ext/shinylive/shinylive.lua
+++ b/_extensions/quarto-ext/shinylive/shinylive.lua
@@ -458,6 +458,13 @@ return {
         el.attr.classes = pandoc.List()
         el.attr.classes:insert("shinylive-r")
       end
+      
+      el.text = 
+        "#| '!! shinylive warning !!': |\n"..
+        "#|   shinylive does not work in self-contained HTML documents.\n" .. 
+        "#|   Please set `embed-resources: false` in your metadata.\n" ..
+        el.text
+      
       return el
     end
   }