diff --git a/src/build/mdgen/ghostty_1_footer.md b/src/build/mdgen/ghostty_1_footer.md
index a0516b4c2..7ace64cd8 100644
--- a/src/build/mdgen/ghostty_1_footer.md
+++ b/src/build/mdgen/ghostty_1_footer.md
@@ -30,7 +30,8 @@ for configuration files.
 
 **$HOME/Library/Application Support/com.mitchellh.ghostty**
 
-: **MACOS ONLY** default location for configuration files.
+: **MACOS ONLY** default location for configuration files. This location takes
+precedence over the XDG environment locations.
 
 **LOCALAPPDATA**
 
diff --git a/src/build/mdgen/ghostty_5_footer.md b/src/build/mdgen/ghostty_5_footer.md
index d94ef9b55..c5077ab97 100644
--- a/src/build/mdgen/ghostty_5_footer.md
+++ b/src/build/mdgen/ghostty_5_footer.md
@@ -22,7 +22,8 @@ for configuration files.
 
 **$HOME/Library/Application Support/com.mitchellh.ghostty**
 
-: **MACOS ONLY** default location for configuration files.
+: **MACOS ONLY** default location for configuration files. This location takes
+precedence over the XDG environment locations.
 
 **LOCALAPPDATA**