From b8e3d3dce1bf1bfe64c91472f21b962ab612755e Mon Sep 17 00:00:00 2001 From: Alex Korbonits Date: Mon, 13 Apr 2026 22:43:39 -0700 Subject: [PATCH] doc: note that multi-field arithmetic expressions are not supported Arithmetic filter expressions only work between a single field and a constant (e.g. `price ** 2 > 1000`). Expressions combining two fields (e.g. `price * quantity > 100`) are not currently supported and return an error. Users have repeatedly hit this because the docs listed all arithmetic operators without mentioning this constraint. Add an alert note after the arithmetic examples pointing out the limitation and suggesting storing pre-computed values as a workaround. Co-Authored-By: Claude Sonnet 4.6 Signed-off-by: Alex Korbonits --- .../userGuide/search-query-get/boolean/basic-operators.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/site/en/userGuide/search-query-get/boolean/basic-operators.md b/site/en/userGuide/search-query-get/boolean/basic-operators.md index 485422e5d..f2a471435 100644 --- a/site/en/userGuide/search-query-get/boolean/basic-operators.md +++ b/site/en/userGuide/search-query-get/boolean/basic-operators.md @@ -168,6 +168,12 @@ To find entities where `price` raised to the power of 2 is greater than 1000: filter = 'price ** 2 > 1000' ``` +
+ +Arithmetic operators only support expressions involving a **single field and a constant**. Expressions that combine two fields arithmetically — such as `price * quantity > 100` — are not currently supported and will return an error. If you need to filter on a derived value computed from multiple fields, consider storing the pre-computed value as a separate scalar field at insert time. + +
+ ## Logical Operators Logical operators are used to combine multiple conditions into a more complex filter expression. These include `AND`, `OR`, and `NOT`.