diff --git a/source/_components/tts.microsoft.markdown b/source/_components/tts.microsoft.markdown
index b55acbd0fac6..dd0c6e419bfa 100644
--- a/source/_components/tts.microsoft.markdown
+++ b/source/_components/tts.microsoft.markdown
@@ -2,7 +2,7 @@
 layout: page
 title: "Microsoft Text-to-Speech"
 description: "Instructions how to setup Microsoft Text-to-Speech with Home Assistant."
-date: 2017-10-23 11:00
+date: 2017-11-07 12:00
 sidebar: true
 comments: false
 sharing: true
@@ -27,10 +27,13 @@ tts:
 Configuration variables:
 
 - **api_key** (*Required*): Your API key.
-- **language** (*Optional*): The language to use. Defaults to `en-us`. Accepted values are listed in the documentation mentioned below.
+- **language** (*Optional*): The language to use. Defaults to `en-us`. Accepted values are listed in the documentation mentioned below. Note that if you set the language to anything other than the default of `en-us`, you will need to specify a matching voice type as well.
 - **gender** (*Optional*): The gender you would like to use for the voice. Accepted values are `Female` and `Male`. Defaults to `Female`
 - **type** (*Optional*): The voice type you want to use. Accepted values are listed in the service name mapping [in the documentation](https://docs.microsoft.com/en-us/azure/cognitive-services/Speech/api-reference-rest/bingvoiceoutput). Defaults to `ZiraRUS`
-
+- **rate** (*Optional*): Change the rate of speaking. Example values: `-25%`, `+50%`. Defaults to `+0%` (no change)
+- **volume** (*Optional*): Change the volume of the output. Example values: `-20%`, `+70%`. Defaults to `+0%` (no change)
+- **pitch** (*Optional*): Change the pitch of the output. Example values: `high`. Defaults to `default` (no change)
+- **contour** (*Optional*): Change the contour of the output. This overrides the pitch setting. See the [W3 SSML specification](http://www.w3.org/TR/speech-synthesis/#pitch_contour) for what it does. Example value: `(0%,+0%) (100%,+100%)`
 
 A full configuration sample including optional configuration variables:
 
@@ -39,7 +42,11 @@ A full configuration sample including optional configuration variables:
 tts:
   - platform: microsoft
     api_key: XXXXXXXXX
-    language: en-us
-    gender: male
-    type: BenjaminRUS
+    language: en-gb
+    gender: Male
+    type: George, Apollo
+    rate: +20%
+    volume: -50%
+    pitch: high
+    contour: (0%, +0%) (100%, +100%)
 ```