diff --git a/alacritty.yml b/alacritty.yml
index fb52e0f5..c08713c6 100644
--- a/alacritty.yml
+++ b/alacritty.yml
@@ -201,5 +201,10 @@ mouse_bindings:
 
 # Shell
 #
-# You can set this to a path to your favorite shell, e.g. /bin/fish
-shell:
+# You can set shell.program to the path of your favorite shell, e.g. /bin/fish.
+# Entries in shell.args are passed unmodified as arguments to the shell.
+#
+#shell:
+#  program: /bin/bash
+#  args:
+#    - --login
diff --git a/alacritty_macos.yml b/alacritty_macos.yml
index bceae75d..de60f7ef 100644
--- a/alacritty_macos.yml
+++ b/alacritty_macos.yml
@@ -200,5 +200,10 @@ mouse_bindings:
 
 # Shell
 #
-# You can set this to a path to your favorite shell, e.g. /bin/fish
-shell:
+# You can set shell.program to the path of your favorite shell, e.g. /bin/fish.
+# Entries in shell.args are passed unmodified as arguments to the shell.
+#
+#shell:
+#  program: /bin/bash
+#  args:
+#    - --login