diff --git a/source/includes/options-mongoimport.yaml b/source/includes/options-mongoimport.yaml
index 4026aa5b077..f1173da3c91 100644
--- a/source/includes/options-mongoimport.yaml
+++ b/source/includes/options-mongoimport.yaml
@@ -309,8 +309,8 @@ description: |
   :program:`mongod`'s performance.
 
   .. versionchanged:: 3.0.0
-    {{role}} is no longer needed when specifying upserts. Use
-    :option:`--upsertFields`, which produces the same behavior.
+    :option:`--upsertFields` now implies {{role}}. As such, you may
+    prefer to use :option:`--upsertFields` instead of {{role}}.
 optional: true
 ---
 program: mongoimport
@@ -327,7 +327,8 @@ description: |
   .. versionchanged:: 3.0.0
     Modifies the import process to update existing objects in the
     database if they match based on the specified fields, while
-    inserting all other objects.
+    inserting all other objects. You do not need to use :option:`--upsert`
+    with {{role}}.
 
     If you do not specify a field, {{role}} will upsert on the basis of
     the ``_id`` field.