diff --git a/content/blocks/preview.md b/content/blocks/preview.md
index 0c8ff90..a7047f7 100644
--- a/content/blocks/preview.md
+++ b/content/blocks/preview.md
@@ -7,10 +7,19 @@ description: >-
   dimensions and responsive controls.
 type: docs
 tags: block
+modules: ["preview"]
 ---
 
 ## Overview
 
+> [!IMPORTANT]
+> Since {{< release version="v2.8.0" short="true" link-type="link" >}}, the
+> `preview` block requires the `preview` JS module for device switching and
+> auto-scaling. Add `modules: ["preview"]` to the front matter of any page that
+> uses this block. Sites that use `preview` on many pages can set
+> `integration = "core"` for the preview module in their `params.toml` to load
+> it globally instead.
+
 ### Basic preview
 
 The `preview` content block renders a live URL preview in an iframe with device switcher controls. By default, it displays in desktop view.