diff --git a/wiki/Home.md b/wiki/Home.md
index f4a0fcb..ab6e12d 100644
--- a/wiki/Home.md
+++ b/wiki/Home.md
@@ -61,7 +61,8 @@ What to click in the dashboard after deploy:
 3. `cmd.calibrate.level = 1.5 m` → the volume integrator syncs to a known level.
 4. Watch Port 0 in the debug pane: level rises, predicted volume integrates, demand follows the curve.
 
-![Basic demo — level rises, demand follows](_partial-gifs/pumpingStation/01-basic-demo.gif)
+> [!IMPORTANT]
+> **GIF needed.** Demo recording of the basic flow reacting to mode + inflow clicks. Save as `wiki/_partial-gifs/pumpingStation/01-basic-demo.gif`, target ≤ 1 MB after `gifsicle -O3 --lossy=80`.
 
 ---
 
diff --git a/wiki/Reference-Examples.md b/wiki/Reference-Examples.md
index 6950529..81e72cd 100644
--- a/wiki/Reference-Examples.md
+++ b/wiki/Reference-Examples.md
@@ -57,7 +57,8 @@ Driver injects are wrapped in four numbered groups: **1. Control mode**, **2. Fl
 3. In manual mode: click `set.demand = 40` — the value surfaces as `manualDemand` on Port 0/1 and in the node status badge.
 4. Click `cmd.calibrate.volume = 25 m³` (or `cmd.calibrate.level = 1.5 m`) to snap the predicted-volume integrator.
 
-![Basic demo — level rises, demand follows](_partial-gifs/pumpingStation/01-basic-demo.gif)
+> [!IMPORTANT]
+> **GIF needed.** Demo recording of steps 1–4. Save as `wiki/_partial-gifs/pumpingStation/01-basic-demo.gif`, target ≤ 1 MB after `gifsicle -O3 --lossy=80`.
 
 ---