From 231f074d68d35759a2f8f5120eed23c0caa20178 Mon Sep 17 00:00:00 2001
From: Mark Dumay <61946753+markdumay@users.noreply.github.com>
Date: Fri, 17 Apr 2026 07:08:32 +0200
Subject: [PATCH] fix: reference optional preview module

---
 content/blocks/preview.md | 9 +++++++++
 1 file changed, 9 insertions(+)

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.