diff --git a/assets/settings/default.json b/assets/settings/default.json
index edbe5caa37..95f43880f1 100644
--- a/assets/settings/default.json
+++ b/assets/settings/default.json
@@ -453,7 +453,8 @@
     // Send anonymized usage data like what languages you're using Zed with.
     "metrics": true
   },
-  // Automatically update Zed
+  // Automatically update Zed. This setting may be ignored on Linux if
+  // installed through a package manager.
   "auto_update": true,
   // Diagnostics configuration.
   "diagnostics": {