diff --git a/contract/README.rst b/contract/README.rst
index 2e10dcabb..6cd3860e0 100644
--- a/contract/README.rst
+++ b/contract/README.rst
@@ -30,6 +30,8 @@ invoicing functions. Also you can print and send by email contract report.
 
 It works for customer contract and supplier contracts.
 
+Contracts are shown in portal.
+
 **Table of contents**
 
 .. contents::
@@ -41,6 +43,8 @@ Configuration
 To view discount field in contract line, you need to set *Discount on lines* in
 user access rights.
 
+Contracts can be viewed on the portal (list and detail) if the user logged into the portal is a follower of the contract.
+
 Usage
 =====
 
@@ -70,6 +74,12 @@ Usage
    They allow to define default journal, price list and lines when creating a contract.
    To use it, just select the template on the contract and fields will be filled automatically.
 
+* Contracts appear in portal to following users in every contract:
+
+.. image:: https://raw.githubusercontent.com/OCA/contract/13.0/contract/static/src/screenshots/portal-my.png
+.. image:: https://raw.githubusercontent.com/OCA/contract/13.0/contract/static/src/screenshots/portal-list.png
+.. image:: https://raw.githubusercontent.com/OCA/contract/13.0/contract/static/src/screenshots/portal-detail.png
+
 Known issues / Roadmap
 ======================
 
diff --git a/contract/static/description/index.html b/contract/static/description/index.html
index 62550489f..e9b97a74c 100644
--- a/contract/static/description/index.html
+++ b/contract/static/description/index.html
@@ -371,6 +371,7 @@ ul.auto-toc {
 <p>This module enables contracts management with recurring
 invoicing functions. Also you can print and send by email contract report.</p>
 <p>It works for customer contract and supplier contracts.</p>
+<p>Contracts are shown in portal.</p>
 <p><strong>Table of contents</strong></p>
 <div class="contents local topic" id="contents">
 <ul class="simple">
@@ -390,6 +391,7 @@ invoicing functions. Also you can print and send by email contract report.</p>
 <h1><a class="toc-backref" href="#id1">Configuration</a></h1>
 <p>To view discount field in contract line, you need to set <em>Discount on lines</em> in
 user access rights.</p>
+<p>Contracts can be viewed on the portal (list and detail) if the user logged into the portal is a follower of the contract.</p>
 </div>
 <div class="section" id="usage">
 <h1><a class="toc-backref" href="#id2">Usage</a></h1>
@@ -420,6 +422,12 @@ contract.</li>
 They allow to define default journal, price list and lines when creating a contract.
 To use it, just select the template on the contract and fields will be filled automatically.</li>
 </ol>
+<ul class="simple">
+<li>Contracts appear in portal to following users in every contract:</li>
+</ul>
+<img alt="https://raw.githubusercontent.com/OCA/contract/13.0/contract/static/src/screenshots/portal-my.png" src="https://raw.githubusercontent.com/OCA/contract/13.0/contract/static/src/screenshots/portal-my.png" />
+<img alt="https://raw.githubusercontent.com/OCA/contract/13.0/contract/static/src/screenshots/portal-list.png" src="https://raw.githubusercontent.com/OCA/contract/13.0/contract/static/src/screenshots/portal-list.png" />
+<img alt="https://raw.githubusercontent.com/OCA/contract/13.0/contract/static/src/screenshots/portal-detail.png" src="https://raw.githubusercontent.com/OCA/contract/13.0/contract/static/src/screenshots/portal-detail.png" />
 </div>
 <div class="section" id="known-issues-roadmap">
 <h1><a class="toc-backref" href="#id3">Known issues / Roadmap</a></h1>