diff --git a/kitty/kitty.conf b/kitty/kitty.conf
index bb748819f..15b5f1888 100644
--- a/kitty/kitty.conf
+++ b/kitty/kitty.conf
@@ -104,6 +104,8 @@ select_by_word_characters :@-./_~?&=%+#
 
 # The shell program to execute. The default value of . means
 # to use whatever shell is set as the default shell for the current user.
+# Note that on macOS if you change this, you might need to add --login to
+# ensure that the shell starts in interactive mode and reads its rc files.
 shell .
 
 # Hide mouse cursor after the specified number of seconds of the mouse not being used. Set to