diff --git a/specs/search/paths/objects/partialUpdate.yml b/specs/search/paths/objects/partialUpdate.yml
index a80bc80fc8..029192297d 100644
--- a/specs/search/paths/objects/partialUpdate.yml
+++ b/specs/search/paths/objects/partialUpdate.yml
@@ -31,6 +31,8 @@ post:
     - _operation: the operation to apply on the attribute
     - value: the right-hand side argument to the operation, for example, increment or decrement step, value to add or remove.
 
+    When updating multiple attributes or using multiple operations targeting the same record, you should use a single partial update for faster processing.
+
     This operation is subject to [indexing rate limits](https://support.algolia.com/hc/en-us/articles/4406975251089-Is-there-a-rate-limit-for-indexing-on-Algolia).
   parameters:
     - $ref: '../../../common/parameters.yml#/IndexName'