diff --git a/.changes/unreleased/heic-support.md b/.changes/unreleased/heic-support.md
index 4130b79..d30c751 100644
--- a/.changes/unreleased/heic-support.md
+++ b/.changes/unreleased/heic-support.md
@@ -4,4 +4,4 @@ body: Add HEIC/HEIF, GIF image and MOV video format support via FFmpeg
 time: 2026-01-25T21:00:00Z
 ---
 
-HEIC (High Efficiency Image Container), HEIF (High Efficiency Image Format), GIF, and MOV (QuickTime) files are now fully supported. These formats, commonly used by iOS devices and other platforms, are decoded using FFmpeg when available. The extensions `.heic`, `.heif`, `.gif`, and `.mov` are now included in the default configuration, so Photofield will automatically index and display these files alongside your other media.
+HEIC (High Efficiency Image Container), HEIF (High Efficiency Image Format), GIF, and MOV (QuickTime) files are now supported when FFmpeg is available. These formats, commonly used by iOS devices and other platforms, are decoded using FFmpeg. The extensions `.heic`, `.heif`, `.gif`, and `.mov` are now included in the default configuration, so Photofield will automatically index and display these files alongside your other media when FFmpeg is installed.
diff --git a/Dockerfile b/Dockerfile
index 32d8e20..ee57400 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -21,7 +21,7 @@ FROM alpine:3.23
 
 # Install runtime dependencies
 # - exiftool: metadata extraction
-# - ffmpeg: video thumbnails, HEIC/HEIF/MOV/GIF support (8.0.1+ includes HEVC decoder)
+# - ffmpeg: video thumbnails, HEIC/HEIF/MOV/GIF support (requires build with HEVC/H.265 decoder + libheif; v7.0+ recommended, see docs)
 # - libjpeg-turbo-utils: fast JPEG decoding via djpeg
 # - libwebp: WebP encoding support
 RUN apk add --no-cache exiftool ffmpeg libjpeg-turbo-utils libwebp && \