diff --git a/docs/en/watcher/actions/email.asciidoc b/docs/en/watcher/actions/email.asciidoc
index 4a45a2bf801..e8a24231291 100644
--- a/docs/en/watcher/actions/email.asciidoc
+++ b/docs/en/watcher/actions/email.asciidoc
@@ -347,10 +347,13 @@ xpack.notification.email.account:
             starttls.enable: true
             host: smtp-mail.outlook.com
             port: 587
-            user: <username>
+            user: <email.address>
             password: <password>
 --------------------------------------------------
 
+When sending emails, you have to provide a from address, either a default one
+in your account configuration or as part of the email action in the watch.
+
 NOTE:   You need to use a unique App Password if two-step verification is enabled.
         See http://windows.microsoft.com/en-us/windows/app-passwords-two-step-verification[App
         passwords and two-step verification] for more information.