diff --git a/attachment_preview/README.rst b/attachment_preview/README.rst
index 28f8ea5c..c65b0349 100644
--- a/attachment_preview/README.rst
+++ b/attachment_preview/README.rst
@@ -29,7 +29,7 @@ This addon allows to preview attachments supported by http://viewerjs.org.
 
 Currently, that's most Libreoffice files and PDFs.
 
-.. image:: /attachment_preview/static/description/screenshot-split.png
+.. image:: https://raw.githubusercontent.com/attachment_preview/static/description/screenshot-split.png
    :alt: Screenshot of split form view
    :width: 100%
 
@@ -55,7 +55,7 @@ menu it's shown next to the form view. From this screen you can navigate
 through the attachments using the arrow buttons. Using the pop-out button
 next to the navigational buttons you can open the preview in a separate window.
 
-.. image:: /attachment_preview/static/description/screenshot-paginator.png
+.. image:: https://raw.githubusercontent.com/attachment_preview/static/description/screenshot-paginator.png
    :alt: Screenshot navigator
 
 Bug Tracker
diff --git a/attachment_preview/static/description/index.html b/attachment_preview/static/description/index.html
index 988c69e6..28ae9376 100644
--- a/attachment_preview/static/description/index.html
+++ b/attachment_preview/static/description/index.html
@@ -370,6 +370,7 @@ ul.auto-toc {
 <p><a class="reference external" href="https://odoo-community.org/page/development-status"><img alt="Beta" src="https://img.shields.io/badge/maturity-Beta-yellow.png" /></a> <a class="reference external" href="http://www.gnu.org/licenses/agpl-3.0-standalone.html"><img alt="License: AGPL-3" src="https://img.shields.io/badge/licence-AGPL--3-blue.png" /></a> <a class="reference external" href="https://github.com/OCA/knowledge/tree/11.0/attachment_preview"><img alt="OCA/knowledge" src="https://img.shields.io/badge/github-OCA%2Fknowledge-lightgray.png?logo=github" /></a> <a class="reference external" href="https://translation.odoo-community.org/projects/knowledge-11-0/knowledge-11-0-attachment_preview"><img alt="Translate me on Weblate" src="https://img.shields.io/badge/weblate-Translate%20me-F47D42.png" /></a> <a class="reference external" href="https://runbot.odoo-community.org/runbot/118/11.0"><img alt="Try me on Runbot" src="https://img.shields.io/badge/runbot-Try%20me-875A7B.png" /></a></p>
 <p>This addon allows to preview attachments supported by <a class="reference external" href="http://viewerjs.org">http://viewerjs.org</a>.</p>
 <p>Currently, that’s most Libreoffice files and PDFs.</p>
+<img alt="Screenshot of split form view" src="https://raw.githubusercontent.com/attachment_preview/static/description/screenshot-split.png" style="width: 100%;" />
 <p><strong>Table of contents</strong></p>
 <div class="contents local topic" id="contents">
 <ul class="simple">
@@ -397,7 +398,11 @@ ul.auto-toc {
 <div class="section" id="usage">
 <h1><a class="toc-backref" href="#id2">Usage</a></h1>
 <p>The module adds a little print preview icon right of download links for
-attachments or binary fields.</p>
+attachments or binary fields. When a preview is opened from the attachments
+menu it’s shown next to the form view. From this screen you can navigate
+through the attachments using the arrow buttons. Using the pop-out button
+next to the navigational buttons you can open the preview in a separate window.</p>
+<img alt="Screenshot navigator" src="https://raw.githubusercontent.com/attachment_preview/static/description/screenshot-paginator.png" />
 </div>
 <div class="section" id="bug-tracker">
 <h1><a class="toc-backref" href="#id3">Bug Tracker</a></h1>