diff --git a/src/build/mdgen/ghostty_1_footer.md b/src/build/mdgen/ghostty_1_footer.md
index 86a8a8098..bd261a68b 100644
--- a/src/build/mdgen/ghostty_1_footer.md
+++ b/src/build/mdgen/ghostty_1_footer.md
@@ -4,6 +4,10 @@ _\$XDG_CONFIG_HOME/ghostty/config_
 
 : Location of the default configuration file.
 
+_\$HOME/Library/Application Support/com.mitchellh.ghostty/config_
+
+: **On macOS**, location of the default configuration file.
+
 _\$LOCALAPPDATA/ghostty/config_
 
 : **On Windows**, if _\$XDG_CONFIG_HOME_ is not set, _\$LOCALAPPDATA_ will be searched
@@ -23,6 +27,10 @@ for configuration files.
 
 : Default location for configuration files.
 
+**$HOME/Library/Application Support/com.mitchellh.ghostty**
+
+: **MACOS ONLY** default location for configuration files.
+
 **LOCALAPPDATA**
 
 : **WINDOWS ONLY:** alternate location to search for configuration files.
diff --git a/src/build/mdgen/ghostty_5_footer.md b/src/build/mdgen/ghostty_5_footer.md
index 0c893dd07..cdf126b81 100644
--- a/src/build/mdgen/ghostty_5_footer.md
+++ b/src/build/mdgen/ghostty_5_footer.md
@@ -4,6 +4,10 @@ _\$XDG_CONFIG_HOME/ghostty/config_
 
 : Location of the default configuration file.
 
+_\$HOME/Library/Application Support/com.mitchellh.ghostty/config_
+
+: **On macOS**, location of the default configuration file.
+
 _\$LOCALAPPDATA/ghostty/config_
 
 : **On Windows**, if _\$XDG_CONFIG_HOME_ is not set, _\$LOCALAPPDATA_ will be searched
@@ -15,6 +19,10 @@ for configuration files.
 
 : Default location for configuration files.
 
+**$HOME/Library/Application Support/com.mitchellh.ghostty**
+
+: **MACOS ONLY** default location for configuration files.
+
 **LOCALAPPDATA**
 
 : **WINDOWS ONLY:** alternate location to search for configuration files.
diff --git a/src/build/mdgen/ghostty_5_header.md b/src/build/mdgen/ghostty_5_header.md
index aac6c17ea..078133861 100644
--- a/src/build/mdgen/ghostty_5_header.md
+++ b/src/build/mdgen/ghostty_5_header.md
@@ -11,6 +11,11 @@ is on the roadmap but not yet supported. The configuration file must be placed
 at `$XDG_CONFIG_HOME/ghostty/config`, which defaults to `~/.config/ghostty/config`
 if the [XDG environment is not set](https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html).
 
+**If you are using macOS, the configuration file can also be placed at
+`$HOME/Library/Application Support/com.mitchellh.ghostty/config`.** This is the
+default configuration location for macOS. It will be searched before any of the
+XDG environment locations listed above.
+
 The file format is documented below as an example:
 
     # The syntax is "key = value". The whitespace around the equals doesn't matter.