diff --git a/base_search_mail_content/README.rst b/base_search_mail_content/README.rst
index 4c992e886..542e4747f 100644
--- a/base_search_mail_content/README.rst
+++ b/base_search_mail_content/README.rst
@@ -69,6 +69,14 @@ Usage
 Go to any model that contains a chatter (e.g. Contacts, ...). Search
 for content in field 'Message Content'.
 
+Known issues / Roadmap
+======================
+
+This module restricts the message_content search functionality
+to internal users only, addressing the issue faced by project collaborators (portal users)
+as described in https://github.com/OCA/social/issues/1204. Consequently, portal users no
+longer have the ability to search within mail content.
+
 Bug Tracker
 ===========
 
diff --git a/base_search_mail_content/readme/ROADMAP.rst b/base_search_mail_content/readme/ROADMAP.rst
new file mode 100644
index 000000000..12b7b3144
--- /dev/null
+++ b/base_search_mail_content/readme/ROADMAP.rst
@@ -0,0 +1,4 @@
+This module restricts the message_content search functionality
+to internal users only, addressing the issue faced by project collaborators (portal users)
+as described in https://github.com/OCA/social/issues/1204. Consequently, portal users no
+longer have the ability to search within mail content.
diff --git a/base_search_mail_content/static/description/index.html b/base_search_mail_content/static/description/index.html
index 30116d5f0..2bbd7374f 100644
--- a/base_search_mail_content/static/description/index.html
+++ b/base_search_mail_content/static/description/index.html
@@ -411,6 +411,13 @@ perform the searches on mail messages.</p>
 <p>Go to any model that contains a chatter (e.g. Contacts, …). Search
 for content in field ‘Message Content’.</p>
 </div>
+<div class="section" id="known-issues-roadmap">
+<h1><a class="toc-backref" href="#id3">Known issues / Roadmap</a></h1>
+<p>This module restricts the message_content search functionality
+to internal users only, addressing the issue faced by project collaborators (portal users)
+as described in <a class="reference external" href="https://github.com/OCA/social/issues/1204">https://github.com/OCA/social/issues/1204</a>. Consequently, portal users no
+longer have the ability to search within mail content.</p>
+</div>
 <div class="section" id="bug-tracker">
 <h1><a class="toc-backref" href="#toc-entry-3">Bug Tracker</a></h1>
 <p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/social/issues">GitHub Issues</a>.