diff --git a/azure/src/wizard/VerifyProvidersStep.ts b/azure/src/wizard/VerifyProvidersStep.ts
index 484d6bd4dd..37083f6285 100644
--- a/azure/src/wizard/VerifyProvidersStep.ts
+++ b/azure/src/wizard/VerifyProvidersStep.ts
@@ -44,7 +44,7 @@ export class VerifyProvidersStep<T extends ISubscriptionActionContext> extends A
                 /**
                  * @param providerError
                  * @deprecated
-                 * Continue to emit telemetry for clients who are still using this property.
+                 * Continue to emit telemetry for clients who are still using this property. You should suppress this property if you need to migrate to the new replacement.
                  *
                  * @param providerError2
                  * A duplicate replacement of the `providerError` telemetry property.
diff --git a/utils/src/callWithTelemetryAndErrorHandling.ts b/utils/src/callWithTelemetryAndErrorHandling.ts
index 02167345c1..ebdabe105a 100644
--- a/utils/src/callWithTelemetryAndErrorHandling.ts
+++ b/utils/src/callWithTelemetryAndErrorHandling.ts
@@ -140,10 +140,10 @@ function handleError(context: types.IActionContext, callbackId: string, error: u
             /**
              * @param errorMessage
              * @deprecated
-             * Continue to emit telemetry for clients who are still using this property.
+             * Continue to emit telemetry for clients who are still using this property. You should suppress this property if you need to migrate to the new replacement.
              *
              * @param errorMessage2
-             * A duplicate replacement of the `errorMessage` telemetry property.
+             * A duplicate replacement of the `errorMessage` telemetry property which should be used instead.
              */
             context.telemetry.properties.errorMessage = errorData.message;
             context.telemetry.properties.errorMessage2 = errorData.message;