diff --git a/flyctl/cmd/fly_machine.md b/flyctl/cmd/fly_machine.md
index f530dabdd6..61c3cedf16 100644
--- a/flyctl/cmd/fly_machine.md
+++ b/flyctl/cmd/fly_machine.md
@@ -27,6 +27,7 @@ fly machine [command] [flags]
 * [suspend](/docs/flyctl/machine-suspend/)	 - Suspend one or more Fly machines
 * [uncordon](/docs/flyctl/machine-uncordon/)	 - Reactivate all services on a machine
 * [update](/docs/flyctl/machine-update/)	 - Update a machine
+* [wait](/docs/flyctl/machine-wait/)	 - Wait for a machine to reach a state
 
 ## Options
 
diff --git a/flyctl/cmd/fly_machine_wait.md b/flyctl/cmd/fly_machine_wait.md
new file mode 100644
index 0000000000..bbf90882ad
--- /dev/null
+++ b/flyctl/cmd/fly_machine_wait.md
@@ -0,0 +1,30 @@
+Wait for a machine to reach a state
+
+
+## Usage
+~~~
+fly machine wait [id] [flags]
+~~~
+
+## Options
+
+~~~
+  -a, --app string              Application name
+  -c, --config string           Path to application configuration file
+  -h, --help                    help for wait
+      --state string            Machine state to wait for (default "settled")
+  -w, --wait-timeout duration   Time duration to wait for the machine to reach the requested state. (default 5m0s)
+~~~
+
+## Global Options
+
+~~~
+  -t, --access-token string   Fly API Access Token
+      --debug                 Print additional logs and traces
+      --verbose               Verbose output
+~~~
+
+## See Also
+
+* [fly machine](/docs/flyctl/machine/)	 - Manage Fly Machines.
+