diff --git a/pages/common/vagrant-halt.md b/pages/common/vagrant-halt.md
new file mode 100644
index 0000000000..5caead44f2
--- /dev/null
+++ b/pages/common/vagrant-halt.md
@@ -0,0 +1,21 @@
+# vagrant halt
+
+> Shuts down the running machine Vagrant is managing.
+> See also: `vagrant`, `vagrant box`, `vagrant plugin`, `vagrant validate`.
+> More information: <https://developer.hashicorp.com/vagrant/docs/cli/halt>.
+
+- Halt the currently running Vagrant machine gracefully:
+
+`vagrant halt`
+
+- Halt a specific machine by its ID or name gracefully:
+
+`vagrant halt {{id_or_name}}`
+
+- Forcefully halt the current running machine(s) (This can affect multiple running machines if they are part of the same Vagrant environment):
+
+`vagrant halt {{[-f|--force]}}`
+
+- Forcefully halt a specific machine by its ID or name:
+
+`vagrant halt {{[-f|--force]}} {{id_or_name}}`