From f328d115a25f9444b3c0942099aa602fd3ea8b60 Mon Sep 17 00:00:00 2001
From: Christoph Wurst <1374172+ChristophWurst@users.noreply.github.com>
Date: Wed, 25 Mar 2026 09:38:03 +0100
Subject: [PATCH] feat(usermanual): document unified search for Mail

AI-assisted: OpenCode (Claude Haiku 4.5)
Signed-off-by: Christoph Wurst <1374172+ChristophWurst@users.noreply.github.com>
---
 user_manual/groupware/mail.rst | 10 ++++++++++
 user_manual/webinterface.rst   | 13 ++++++++++++-
 2 files changed, 22 insertions(+), 1 deletion(-)

diff --git a/user_manual/groupware/mail.rst b/user_manual/groupware/mail.rst
index 8d1da7490..ce94572b1 100644
--- a/user_manual/groupware/mail.rst
+++ b/user_manual/groupware/mail.rst
@@ -139,6 +139,16 @@ Refresh mailbox
 You can manually trigger a sync of your mailbox by clicking the refresh button located at the top of the mailbox list.
 Starting from ``version 5.7`` triggering the sync will also refresh the list of folders for the selected account.
 
+Unified search
+~~~~~~~~~~~~~~
+
+The Mail app integrates with Nextcloud's :ref:`unified search <unified-search>`
+feature (see :doc:`../webinterface` for details). You can search for emails across
+all your accounts using the search bar in the Nextcloud header.
+
+Mail searches email subjects and sender/recipient fields. To search email bodies,
+use the mailbox search feature in the app.
+
 Search in mailbox
 ~~~~~~~~~~~~~~~~~
 
diff --git a/user_manual/webinterface.rst b/user_manual/webinterface.rst
index 62783e1f0..12a4ab283 100644
--- a/user_manual/webinterface.rst
+++ b/user_manual/webinterface.rst
@@ -66,7 +66,8 @@ The Nextcloud user interface contains the following fields and functions:
    Files Application View to upload them to your instance.
 
 * **Search** field (6): Click on the Magnifier in the upper right corner
-  to search for files and entries of the current app.
+  to perform a :ref:`unified search <unified-search>` across your Nextcloud
+  or search for entries within the current app.
 
 * **Contacts Menu** (7): Gives you an overview about your contacts and users on
   your server. Dependent on the given details and available apps, you can
@@ -93,3 +94,13 @@ The Nextcloud user interface contains the following fields and functions:
   * Nextcloud Version information
 
 See :doc:`userpreferences` section to learn more about these settings.
+
+Unified search
+--------------
+
+.. _unified-search:
+
+Nextcloud's unified search combines results from all your installed apps
+(Files, Mail, Contacts, Calendar, etc.) into a single view. Click the search
+magnifier in the header, type your search term, and results appear grouped
+by app.