diff --git a/src/config/Config.zig b/src/config/Config.zig
index b59161289..2ec773922 100644
--- a/src/config/Config.zig
+++ b/src/config/Config.zig
@@ -27,6 +27,9 @@ const c = @cImport({
 /// The font families to use.
 /// You can generate the list of valid values using the CLI:
 ///   path/to/ghostty/cli +list-fonts
+///
+/// Changing this configuration at runtime will only affect new terminals,
+/// i.e. new windows, tabs, etc.
 @"font-family": ?[:0]const u8 = null,
 @"font-family-bold": ?[:0]const u8 = null,
 @"font-family-italic": ?[:0]const u8 = null,