diff --git a/specification/cognitiveservices/data-plane/QnAMaker/stable/v4.0/QnAMaker.json b/specification/cognitiveservices/data-plane/QnAMaker/stable/v4.0/QnAMaker.json
index 3a42dc889089..2afdea67435e 100644
--- a/specification/cognitiveservices/data-plane/QnAMaker/stable/v4.0/QnAMaker.json
+++ b/specification/cognitiveservices/data-plane/QnAMaker/stable/v4.0/QnAMaker.json
@@ -899,7 +899,7 @@
         },
         "language": {
           "type": "string",
-          "description": "Language of the knowledgebase.",
+          "description": "Language of the knowledgebase. Please find the list of supported languages <a href=\"https://aka.ms/qnamaker-languages#languages-supported\" target=\"_blank\">here</a>.",
           "maxLength": 100,
           "minLength": 1
         }
diff --git a/specification/cognitiveservices/data-plane/QnAMaker/stable/v4.0/QnAMakerRuntime.json b/specification/cognitiveservices/data-plane/QnAMaker/stable/v4.0/QnAMakerRuntime.json
index 843426973bd1..04490d47590a 100644
--- a/specification/cognitiveservices/data-plane/QnAMaker/stable/v4.0/QnAMakerRuntime.json
+++ b/specification/cognitiveservices/data-plane/QnAMaker/stable/v4.0/QnAMakerRuntime.json
@@ -339,7 +339,7 @@
         },
         "userId": {
           "type": "string",
-          "description": "Unique identifier for the user."
+          "description": "Unique identifier for the user. Optional parameter for telemetry. For more information, refer <a href=\"http://aka.ms/qnamaker-analytics#user-traffic\" target=\"blank\">Analytics and Telemetry</a>."
         },
         "isTest": {
           "type": "boolean",