diff --git a/source/_integrations/amazon_polly.markdown b/source/_integrations/amazon_polly.markdown
index 7f4c9059fe9..ba7f4004f82 100644
--- a/source/_integrations/amazon_polly.markdown
+++ b/source/_integrations/amazon_polly.markdown
@@ -42,7 +42,7 @@ aws_secret_access_key:
   required: true
   type: string
 profile_name:
-  description: A credentials profile name.
+  description: A credentials profile name. If provided, you must **not** provide an `aws_access_key_id` nor an `aws_secrete_access_key`. 
   required: false
   type: string
 region_name:
@@ -51,12 +51,12 @@ region_name:
   type: [string, list]
   default: us-east-1
 text_type:
-  description: "Specify wherever to use text (default) or ssml markup by default."
+  description: "Whether to interpret messages as `text` or as [`ssml`](https://docs.aws.amazon.com/polly/latest/dg/ssml.html) by default."
   required: false
   type: string
   default: text
 voice:
-  description: Voice name to be used.
+  description: The [Voice Name/ID](https://docs.aws.amazon.com/polly/latest/dg/voicelist.html) to be used for generated speech by default. 
   required: false
   type: string
 output_format: