diff --git a/client/packages/core/src/Reactor.js b/client/packages/core/src/Reactor.js
index f7d3e1f4c..199b2f131 100644
--- a/client/packages/core/src/Reactor.js
+++ b/client/packages/core/src/Reactor.js
@@ -530,6 +530,10 @@ export default class Reactor {
       message: msg.message || "Uh-oh, something went wrong. Ping Joe & Stopa.",
     };
 
+    if (msg.hint) {
+      errorMessage.hint = msg.hint;
+    }
+
     if (prevMutation) {
       // This must be a transaction error
       const errDetails = {
diff --git a/client/www/pages/docs/instaql.md b/client/www/pages/docs/instaql.md
index db20bdd5e..4d3c9e537 100644
--- a/client/www/pages/docs/instaql.md
+++ b/client/www/pages/docs/instaql.md
@@ -659,6 +659,23 @@ console.log(data)
 }
 ```
 
+### Comparison operators
+
+The `where` clause supports comparison operators on fields that are indexed and have checked types.
+
+{% callout %}
+Add indexes and checked types to your attributes from the [Explorer on the the Instant dashboard](/dash?t=explorer) or from the [cli with Schema-as-code](/docs/schema).
+{% /callout %}
+
+| Operator |       Description        | JS equivalent |
+| :------: | :----------------------: | :-----------: |
+|  `$gt`   |       greater than       |      `>`      |
+|  `$lt`   |        less than         |      `<`      |
+|  `$gte`  | greater than or equal to |     `>=`      |
+|  `$lte`  |  less than or equal to   |     `<=`      |
+
+
+
 ### $not
 
 The `where` clause supports `$not` queries that will return entities that don't