diff --git a/aider/website/assets/sample.aider.conf.yml b/aider/website/assets/sample.aider.conf.yml
index 3e0023ddd..220c80179 100644
--- a/aider/website/assets/sample.aider.conf.yml
+++ b/aider/website/assets/sample.aider.conf.yml
@@ -92,7 +92,7 @@
 ## Suggested number of tokens to use for repo map, use 0 to disable (default: 1024)
 #map-tokens: xxx
 
-## Control how often the repo map is refreshed (default: auto)
+## Control how often the repo map is refreshed. Options: auto, always, files, manual (default: auto)
 #map-refresh: auto
 
 ## Enable caching of prompts (default: False)
diff --git a/aider/website/assets/sample.env b/aider/website/assets/sample.env
index a7a226691..2612d4fa6 100644
--- a/aider/website/assets/sample.env
+++ b/aider/website/assets/sample.env
@@ -96,7 +96,7 @@
 ## Suggested number of tokens to use for repo map, use 0 to disable (default: 1024)
 #AIDER_MAP_TOKENS=
 
-## Control how often the repo map is refreshed (default: auto)
+## Control how often the repo map is refreshed. Options: auto, always, files, manual (default: auto)
 #AIDER_MAP_REFRESH=auto
 
 ## Enable caching of prompts (default: False)
diff --git a/aider/website/docs/config/aider_conf.md b/aider/website/docs/config/aider_conf.md
index b992d69b2..2e05b86e5 100644
--- a/aider/website/docs/config/aider_conf.md
+++ b/aider/website/docs/config/aider_conf.md
@@ -140,7 +140,7 @@ cog.outl("```")
 ## Suggested number of tokens to use for repo map, use 0 to disable (default: 1024)
 #map-tokens: xxx
 
-## Control how often the repo map is refreshed (default: auto)
+## Control how often the repo map is refreshed. Options: auto, always, files, manual (default: auto)
 #map-refresh: auto
 
 ## Enable caching of prompts (default: False)
diff --git a/aider/website/docs/config/dotenv.md b/aider/website/docs/config/dotenv.md
index e31959e17..b9d34a513 100644
--- a/aider/website/docs/config/dotenv.md
+++ b/aider/website/docs/config/dotenv.md
@@ -138,7 +138,7 @@ cog.outl("```")
 ## Suggested number of tokens to use for repo map, use 0 to disable (default: 1024)
 #AIDER_MAP_TOKENS=
 
-## Control how often the repo map is refreshed (default: auto)
+## Control how often the repo map is refreshed. Options: auto, always, files, manual (default: auto)
 #AIDER_MAP_REFRESH=auto
 
 ## Enable caching of prompts (default: False)
diff --git a/aider/website/docs/config/options.md b/aider/website/docs/config/options.md
index 17d2913ac..c6003c166 100644
--- a/aider/website/docs/config/options.md
+++ b/aider/website/docs/config/options.md
@@ -201,7 +201,7 @@ Suggested number of tokens to use for repo map, use 0 to disable (default: 1024)
 Environment variable: `AIDER_MAP_TOKENS`  
 
 ### `--map-refresh VALUE`
-Control how often the repo map is refreshed (default: auto)  
+Control how often the repo map is refreshed. Options: auto, always, files, manual (default: auto)  
 Default: auto  
 Environment variable: `AIDER_MAP_REFRESH`