diff --git a/reference/mongodb/mongodb/driver/manager/construct.xml b/reference/mongodb/mongodb/driver/manager/construct.xml
index 0c003693b1..60bca6db54 100644
--- a/reference/mongodb/mongodb/driver/manager/construct.xml
+++ b/reference/mongodb/mongodb/driver/manager/construct.xml
@@ -71,6 +71,17 @@ mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][
       which will overwrite any options with the same name in the
       <parameter>uri</parameter> parameter.
      </para>
+     <note>
+      <simpara>
+       The <literal>"authMechanism"</literal> and
+       <literal>"authMechanismProperties"</literal> options are not supported in
+       <parameter>uriOptions</parameter> and must be specified in the
+       <parameter>uri</parameter> parameter. For additional details, see
+       <link xlink:href="&url.mongodb.docs;reference/connection-string/#urioption.authMechanism">Authentication Options</link>
+       in the MongoDB manual and the
+       <link xlink:href="&url.mongodb.specs;/blob/master/source/auth/auth.rst#auth-related-options">Driver Authentication Specification</link>.
+      </simpara>
+     </note>
      <para>
       <table>
        <title>uriOptions</title>
@@ -100,18 +111,6 @@ mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][
            </para>
           </entry>
          </row>
-         <row>
-          <entry>authMechanism</entry>
-          <entry><type>string</type></entry>
-          <entry>
-           <para>
-            The authentication mechanism that MongoDB will use to authenticate
-            the connection. For details, see
-            <link xlink:href="&url.mongodb.docs;reference/connection-string/#urioption.authMechanism">Authentication Options</link>
-            in the MongoDB manual.
-           </para>
-          </entry>
-         </row>
          <row>
           <entry>authSource</entry>
           <entry><type>string</type></entry>