diff --git a/flyctl/cmd/fly_machine_create.md b/flyctl/cmd/fly_machine_create.md
index c6ba028eb7..03c6973e84 100644
--- a/flyctl/cmd/fly_machine_create.md
+++ b/flyctl/cmd/fly_machine_create.md
@@ -34,8 +34,8 @@ fly machine create <image> [command] [flags]
                                     	For example: --port 80/tcp --port 443:80/tcp:http:tls --port 5432/tcp:pg_tls
                                     	To remove a port mapping use '-' as handler. For example: --port 80/tcp:-
   -r, --region string               The target region (see 'flyctl platform regions')
-      --restart string              Set the restart policy for a Machine. Options include 'no', 'always', and 'on-fail'.
-                                    	Default is 'on-fail' for Machines created by 'fly deploy' and Machines with a schedule. Default is 'always' for Machines created by 'fly m run'.
+      --restart string              Set the restart policy for a Machine. Options include 'no', 'always', and 'on-failure'.
+                                    	Default is 'on-failure' for Machines created by 'fly deploy' and Machines with a schedule. Default is 'always' for Machines created by 'fly m run'.
       --rm                          Automatically remove the Machine when it exits. Sets the restart-policy to 'never' if not otherwise specified.
       --rootfs-fs-size string       Root filesystem size in GB. Accepts a plain number (in GB) or a human-readable size (e.g. 2gb, 5gb). Sets the size of the filesystem itself, independent of the rootfs volume size. Set to 0 to unset.
       --rootfs-persist string       Whether to persist the root filesystem across restarts. Options include 'never', 'always', and 'restart'.
diff --git a/flyctl/cmd/fly_machine_run.md b/flyctl/cmd/fly_machine_run.md
index d6881e2b8e..afe65a36b1 100644
--- a/flyctl/cmd/fly_machine_run.md
+++ b/flyctl/cmd/fly_machine_run.md
@@ -36,8 +36,8 @@ fly machine run <image> [command] [flags]
                                     	For example: --port 80/tcp --port 443:80/tcp:http:tls --port 5432/tcp:pg_tls
                                     	To remove a port mapping use '-' as handler. For example: --port 80/tcp:-
   -r, --region string               The target region (see 'flyctl platform regions')
-      --restart string              Set the restart policy for a Machine. Options include 'no', 'always', and 'on-fail'.
-                                    	Default is 'on-fail' for Machines created by 'fly deploy' and Machines with a schedule. Default is 'always' for Machines created by 'fly m run'.
+      --restart string              Set the restart policy for a Machine. Options include 'no', 'always', and 'on-failure'.
+                                    	Default is 'on-failure' for Machines created by 'fly deploy' and Machines with a schedule. Default is 'always' for Machines created by 'fly m run'.
       --rm                          Automatically remove the Machine when it exits. Sets the restart-policy to 'never' if not otherwise specified.
       --rootfs-fs-size string       Root filesystem size in GB. Accepts a plain number (in GB) or a human-readable size (e.g. 2gb, 5gb). Sets the size of the filesystem itself, independent of the rootfs volume size. Set to 0 to unset.
       --rootfs-persist string       Whether to persist the root filesystem across restarts. Options include 'never', 'always', and 'restart'.
diff --git a/flyctl/cmd/fly_machine_update.md b/flyctl/cmd/fly_machine_update.md
index cc6d9d2090..b1bdee6cbe 100644
--- a/flyctl/cmd/fly_machine_update.md
+++ b/flyctl/cmd/fly_machine_update.md
@@ -35,8 +35,8 @@ fly machine update [machine_id] [flags]
   -p, --port strings                The external ports and handlers for services, in the format: port[:machinePort][/protocol[:handler[:handler...]]])
                                     	For example: --port 80/tcp --port 443:80/tcp:http:tls --port 5432/tcp:pg_tls
                                     	To remove a port mapping use '-' as handler. For example: --port 80/tcp:-
-      --restart string              Set the restart policy for a Machine. Options include 'no', 'always', and 'on-fail'.
-                                    	Default is 'on-fail' for Machines created by 'fly deploy' and Machines with a schedule. Default is 'always' for Machines created by 'fly m run'.
+      --restart string              Set the restart policy for a Machine. Options include 'no', 'always', and 'on-failure'.
+                                    	Default is 'on-failure' for Machines created by 'fly deploy' and Machines with a schedule. Default is 'always' for Machines created by 'fly m run'.
       --rootfs-fs-size string       Root filesystem size in GB. Accepts a plain number (in GB) or a human-readable size (e.g. 2gb, 5gb). Sets the size of the filesystem itself, independent of the rootfs volume size. Set to 0 to unset.
       --rootfs-persist string       Whether to persist the root filesystem across restarts. Options include 'never', 'always', and 'restart'.
       --rootfs-size string          Root filesystem size in GB. Accepts a plain number (in GB) or a human-readable size (e.g. 2gb, 5gb). Uses an overlayfs to allow the root filesystem to exceed its default size. Set to 0 to unset.