diff --git a/docs/references/account/update-prefs.md b/docs/references/account/update-prefs.md
index cdfbdf9f04..8283f2f7c6 100644
--- a/docs/references/account/update-prefs.md
+++ b/docs/references/account/update-prefs.md
@@ -1 +1 @@
-Update currently logged in user account preferences. You can pass only the specific settings you wish to update.
\ No newline at end of file
+Update currently logged in user account preferences. The object you pass is stored as is, and replaces any previous value.
\ No newline at end of file
diff --git a/docs/references/users/update-user-prefs.md b/docs/references/users/update-user-prefs.md
index cb06d4a7f3..3927363676 100644
--- a/docs/references/users/update-user-prefs.md
+++ b/docs/references/users/update-user-prefs.md
@@ -1 +1 @@
-Update the user preferences by its unique ID. You can pass only the specific settings you wish to update.
\ No newline at end of file
+Update the user preferences by its unique ID. The object you pass is stored as is, and replaces any previous value.
\ No newline at end of file