diff --git a/website/source/docs/vagrantfile/machine_settings.html.md b/website/source/docs/vagrantfile/machine_settings.html.md
index 6a6e1d078..7d6fe9a19 100644
--- a/website/source/docs/vagrantfile/machine_settings.html.md
+++ b/website/source/docs/vagrantfile/machine_settings.html.md
@@ -133,7 +133,8 @@ networks.
 
 `config.vm.hostname` - The hostname the machine should have. Defaults
 to nil. If nil, Vagrant will not manage the hostname. If set to a string,
-the hostname will be set on boot.
+the hostname will be set on boot. If set, Vagrant will update `/etc/hosts`
+on the guest with the configured hostname.
 
 <hr>