diff --git a/src/build/mdgen/ghostty_1_footer.md b/src/build/mdgen/ghostty_1_footer.md
index bd261a68b..a0516b4c2 100644
--- a/src/build/mdgen/ghostty_1_footer.md
+++ b/src/build/mdgen/ghostty_1_footer.md
@@ -6,7 +6,8 @@ _\$XDG_CONFIG_HOME/ghostty/config_
 
 _\$HOME/Library/Application Support/com.mitchellh.ghostty/config_
 
-: **On macOS**, location of the default configuration file.
+: **On macOS**, location of the default configuration file. This location takes
+precedence over the XDG environment locations.
 
 _\$LOCALAPPDATA/ghostty/config_
 
diff --git a/src/build/mdgen/ghostty_5_footer.md b/src/build/mdgen/ghostty_5_footer.md
index cdf126b81..d94ef9b55 100644
--- a/src/build/mdgen/ghostty_5_footer.md
+++ b/src/build/mdgen/ghostty_5_footer.md
@@ -6,7 +6,8 @@ _\$XDG_CONFIG_HOME/ghostty/config_
 
 _\$HOME/Library/Application Support/com.mitchellh.ghostty/config_
 
-: **On macOS**, location of the default configuration file.
+: **On macOS**, location of the default configuration file. This location takes
+precedence over the XDG environment locations.
 
 _\$LOCALAPPDATA/ghostty/config_