diff --git a/docs/channels/discord.md b/docs/channels/discord.md
index ce9dc04f3..b9c13cd5c 100644
--- a/docs/channels/discord.md
+++ b/docs/channels/discord.md
@@ -345,7 +345,7 @@ Reaction notifications use `guilds.<id>.reactionNotifications`:
 | messages | enabled | Read/send/edit/delete |
 | threads | enabled | Create/list/reply |
 | pins | enabled | Pin/unpin/list |
-| search | enabled | Message search (preview feature) |
+| search | enabled | Message search (preview feature). Note: queries are simple keyword matching; don’t use boolean operators like `OR` — run multiple searches instead. |
 | memberInfo | enabled | Member info |
 | roleInfo | enabled | Role list |
 | channelInfo | enabled | Channel info + list |