diff --git a/adaptors/collections.md b/adaptors/collections.md
index b9ef5e818f67..a693df81fc92 100644
--- a/adaptors/collections.md
+++ b/adaptors/collections.md
@@ -295,7 +295,7 @@ You'll need to set configuration on the state.json:
 {
   "configuration": {
     "collections_endpoint": "http://localhost:4000/collections",
-    "collections_token": "...paste the token from the app..."
+    "collections_token": "...paste your Personal Access Token..."
   }
 }
 ```
@@ -311,7 +311,7 @@ If you're using `workflow.json`, set the token and endpoint on
     "steps": [ ... ],
     "credentials": {
       "collections_endpoint": "http://localhost:4000/collections",
-      "collections_token": "...paste the token from the app..."
+      "collections_token": "...paste your Personal Access Token..."
     }
   }
 }
diff --git a/docs/build/collections.md b/docs/build/collections.md
index 7f1709102229..d68dae597c66 100644
--- a/docs/build/collections.md
+++ b/docs/build/collections.md
@@ -142,7 +142,9 @@ collections.each(
 );
 ```
 
-New values are uploaded to a collection through `collections.set`:
+Values are uploaded to a collection through `collections.set`. All sets are "upserts" - meaning that new keys will be created for values that don't exist, and values will be updated for keys that _do_ exist. 
+
+The example below sets a single item:
 
 ```js
 collections.set('openfn-demo', 'commcare-fhir-value-mappings', {