This module enables searching for messages across any record that uses the chatter, based on their associated conversation threads. It dynamically adds a Message Search field to the search view of any model that inherits from mail.thread.
The Message Search field performs a smart, per-word search across a message’s subject, body, sender, and reply-to fields.
auto_awesome What this module does
AI-generated from the code · Odoo 19.0Adds a 'Message Search' field to the search screens of every record type that uses the chatter, so users can find records by words contained in their messages' subject, body, sender or reply-to.
This module extends the chatter (the message history attached to records) so that users can search records by the content of their messages, not just by the record's own fields.
Where it appears: - On the search screen of any model that uses the chatter, an extra search field called Message Search is added automatically, next to the other search fields. - It is only shown to internal users.
How the search works: - The words typed are split and each word is looked for in the message subject, body, sender address and reply-to address. - With a normal search, a record is returned if any of those message fields contains the word; with several words, all words must be found somewhere in the messages. - With a negative search (such as 'is not'), the logic is inverted per word. - Only messages belonging to the same record type being searched are considered, so results stay relevant.
Automatic behaviour and limits:
- An optional system setting named mail_message_search.message_limit can cap how many messages are examined; if it is not set, no limit is applied.
- The search field itself is a technical helper: it is not stored and shows nothing on forms, it only works inside searches.
It touches the shared chatter model mail.thread and the message model mail.message, and does not add any menu of its own.
Depends on
Models and fields (1)
- mail.thread · extends an existing modelmessage_search
Text generated by AI (DeepSeek) from reading the Odoo 19.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub
Availability by version
Reviewed: 2026-11-03Confirmation status: 4 confirmed, 5 with no information of 9 versions.
Sources · Odoo 19.0
Confirmed on 2026-11-03 in branch 19.0 of OCA/mail.
terminal Installation and usage
OCA documentation · Odoo 19.0Configuration
Source · Odoo 19.0If your database is very large, you can limit how many messages a search returns to prevent crashes.
- Go to Settings ▸ Technical ▸ System Parameters.
- Add a new parameter:
- Key: mail_message_search.message_limit
- Value: your desired limit (e.g., 5000).
Usage
Source · Odoo 19.0Go to any model that contains a chatter (e.g. Contacts, ...). Search for content in field 'Message Search'.
No verified information in OCA: Installation.
Installation instructions, the distribution package, dependencies and configuration steps are not shown because they have not yet been verified in the module documentation for any version.
Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.