diff --git a/fern/pages/docs/actions/record.mdx b/fern/pages/docs/actions/record.mdx
index eaaa45a..6647ce9 100644
--- a/fern/pages/docs/actions/record.mdx
+++ b/fern/pages/docs/actions/record.mdx
@@ -8,6 +8,8 @@ The `record` action starts recording the browser viewport as a video file (MP4,
 
 *Note: Recording is currently only supported in visible Chrome browsers.*
 
+*Note: On macOS, Chrome needs screen recording permission. If recording fails, enable Chrome in **System Settings** (or **System Preferences** on older versions) > **Privacy & Security** > **Screen Recording**.*
+
 You can specify the recording action in several ways:
 
 - **Boolean Shorthand:** Set `record: true` to start recording with default settings (usually saved as `record_<timestamp>.mp4` in the output directory).