OCA/mail · 19.0
Mail Message Search
mail_message_search
Mail Message Search
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.
Table of contents
Use Cases / Context
This module offers an alternative to base_search_mail_content,
designed to better support languages that do not separate words with
spaces (e.g., Chinese, Japanese, Korean, Thai).
The original module relies on PostgreSQL's pg_trgm, which requires
three-character tokens and a similarity score above the default
cutoff—making it ineffective for languages without space-separated
words.
This module uses direct keyword matching across key fields in
mail.message, offering more reliable results in multilingual
environments.
Configuration
If 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
Go to any model that contains a chatter (e.g. Contacts, ...). Search for content in field 'Message Search'.
Bug Tracker
Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us to smash it by providing a detailed and welcomed feedback.
Do not contact contributors directly about support or help with technical issues.
Credits
Authors
- Quartile
Contributors
- Quartile:
- Aung Ko Ko Lin
- Yoshi Tashiro
Other credits
The migration of this module from 18.0 to 19.0 was financially supported by Agent ERP GmbH
Maintainers
This module is maintained by the OCA.
OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.
Current maintainers:
This module is part of the OCA/mail project on GitHub.
You are welcome to contribute. To learn how please visit <https://odoo-community.org/page/Contribute>.







