diff --git a/source/_components/notify.smtp.markdown b/source/_components/notify.smtp.markdown
index f90671994fc..d56dcc00c0d 100644
--- a/source/_components/notify.smtp.markdown
+++ b/source/_components/notify.smtp.markdown
@@ -12,7 +12,7 @@ ha_category: Notifications
 ---
 
 
-The smtp platform allows you to deliver notifications from Home Assistant to an e-mail recipient.
+The `smtp` platform allows you to deliver notifications from Home Assistant to an e-mail recipient.
 
 To enable notification by e-mail in your installation, add the following to your `configuration.yaml` file:
 
@@ -33,14 +33,13 @@ notify:
 Configuration variables:
 
 - **name** (*Optional*): Setting the optional parameter `name` allows multiple notifiers to be created. The default value is `notify`. The notifier will bind to the service `notify.NOTIFIER_NAME`.
-- **server** (*Required*): SMTP server which is used to end the notifications. For Google Mail, eg. smtp.gmail.com. Keep in mind that Google has some extra layers of protection which need special attention (Hint: 'Less secure apps').
-- **port** (*Required*): The port that the SMTP server is using, eg. 587 for Google Mail and STARTTLS or 465/993 depending on your SMTP servers.
-- **sender** (*Required*): E-Mail address of the sender.
-- **username** (*Required*): Username for the SMTP account.
-- **password** (*Required*):Password for the SMTP server that belongs to the given username. If the password contains a colon it need to be wrapped in apostrophes.
+- **server** (*Optional*): SMTP server which is used to end the notifications. For Google Mail, eg. smtp.gmail.com. Keep in mind that Google has some extra layers of protection which need special attention (Hint: 'Less secure apps'). Defaults to `localhost`.
+- **port** (*Optional*): The port that the SMTP server is using, eg. 587 for Google Mail and STARTTLS or 465/993 depending on your SMTP servers.  Defaults to 25.
+- **sender** (*Optional*): E-mail address of the sender.
+- **username** (*Optional*): Username for the SMTP account.
+- **password** (*Optional*):Password for the SMTP server that belongs to the given username. If the password contains a colon it need to be wrapped in apostrophes.
 - **recipient** (*Required*): Recipient of the notification.
-- **starttls** (*Optional*): Enables STARTTLS, eg. 1 or 0.
-
+- **starttls** (*Optional*): Enables STARTTLS, eg. 1 or 0. Defaults to 0.
 
 This platform is fragile and not able to catch all exceptions in a smart way because of the large number of possible configuration combinations.