diff --git a/docs/xdr/features/investigate/sol_ref_operators.md b/docs/xdr/features/investigate/sol_ref_operators.md
index 7fa9f219ba..ede26268b3 100644
--- a/docs/xdr/features/investigate/sol_ref_operators.md
+++ b/docs/xdr/features/investigate/sol_ref_operators.md
@@ -1054,6 +1054,20 @@ Use the `matches regex` operator to filter the rows based on a regex pattern.
 | `(...)` | Forms a group. You can use a group to treat part of the expression as a single character | `abc(def)?` matches 'abc' and 'abcdef' but not 'abcd' |
 | `[...]` | Match one of the character in the brackets<br>Inside the brackets, `-` indicates a range unless `-` is the first character or escaped<br>A `^` before a character in the brackets negates the character or range  | `[abc]` matches 'a', 'b', 'c'<br>`[-abc]` matches '-', 'a', 'b', 'c'<br>`[^abc]` matches any character except 'a', 'b', or 'c' |
 
+The `matches regex` operator uses a restricted regex syntax.
+
+### Unsupported constructs
+
+The following constructs are **not supported**. Using them will return no results without an error message.
+
+| Unsupported construct | Example |
+|---|---|
+| Non-capturing groups | `(?:pattern)` |
+| Named capture groups | `(?P<name>pattern)` |
+| Inline flags | `(?i)`, `(?m)`, `(?s)` |
+| Lookaheads / lookbehinds | `(?=...)`, `(?!...)`, `(?<=...)`, `(?<!...)` |
+| Backreferences | `\1`, `\k<name>` |
+
 !!! info
     Some characters are reserved as operators: `.` `?` `+` `*` `|` `{` `}` `[` `]` `(` `)` `"` `\` .<br>Escape reserved operators with a preceding backslash `\` or surround them with double quotes `""`.<br>`\@` renders as a literal '@'.<br>`\\` renders as a literal '\'.<br>`"john@smith.com"` renders as 'john@smith.com'.
 
@@ -1079,6 +1093,7 @@ Use the `matches regex` operator to filter the rows based on a regex pattern.
         | 2026-03-26T14:22:03.120Z | deploy.sh           |
         | 2026-03-26T14:19:47.883Z | cleanup.sh          |
         | 2026-03-26T14:17:31.554Z | install_agent.sh    |
+        
 
 ## Variables