diff --git a/docs/img/workspace-basics/history-actions.webp b/docs/img/workspace-basics/history-actions.webp
new file mode 100644
index 0000000000..ebde19d054
Binary files /dev/null and b/docs/img/workspace-basics/history-actions.webp differ
diff --git a/docs/img/workspace-basics/history-autosaved.webp b/docs/img/workspace-basics/history-autosaved.webp
new file mode 100644
index 0000000000..291a2082d1
Binary files /dev/null and b/docs/img/workspace-basics/history-autosaved.webp differ
diff --git a/docs/img/workspace-basics/history-navigate.mp4 b/docs/img/workspace-basics/history-navigate.mp4
deleted file mode 100644
index 393f9a1292..0000000000
Binary files a/docs/img/workspace-basics/history-navigate.mp4 and /dev/null differ
diff --git a/docs/img/workspace-basics/history-navigate.webp b/docs/img/workspace-basics/history-navigate.webp
deleted file mode 100644
index 31faae2ded..0000000000
Binary files a/docs/img/workspace-basics/history-navigate.webp and /dev/null differ
diff --git a/docs/img/workspace-basics/history-pin.webp b/docs/img/workspace-basics/history-pin.webp
new file mode 100644
index 0000000000..48e08e5e00
Binary files /dev/null and b/docs/img/workspace-basics/history-pin.webp differ
diff --git a/docs/img/workspace-basics/history-restore.webp b/docs/img/workspace-basics/history-restore.webp
new file mode 100644
index 0000000000..a5d9eb05c2
Binary files /dev/null and b/docs/img/workspace-basics/history-restore.webp differ
diff --git a/docs/img/workspace-basics/history-save.webp b/docs/img/workspace-basics/history-save.webp
new file mode 100644
index 0000000000..bb9c8b13ac
Binary files /dev/null and b/docs/img/workspace-basics/history-save.webp differ
diff --git a/docs/img/workspace-basics/history-view.webp b/docs/img/workspace-basics/history-view.webp
new file mode 100644
index 0000000000..27d7e75487
Binary files /dev/null and b/docs/img/workspace-basics/history-view.webp differ
diff --git a/docs/img/workspace-basics/history.webp b/docs/img/workspace-basics/history.webp
deleted file mode 100644
index b4498af991..0000000000
Binary files a/docs/img/workspace-basics/history.webp and /dev/null differ
diff --git a/docs/user-guide/workspace-basics/index.njk b/docs/user-guide/workspace-basics/index.njk
index 2e0bbceefb..dfb5bee2a4 100644
--- a/docs/user-guide/workspace-basics/index.njk
+++ b/docs/user-guide/workspace-basics/index.njk
@@ -199,33 +199,51 @@ geometric structure. In Penpot there are three types of guides:
   <img src="/img/workspace-basics/shortcuts.webp" alt="Shortcuts panel" />
 </figure>
 
-<h2 id="history">History</h2>
+<h2 id="history">File history versions</h2>
 <p>The history panel keeps track of the latest changes on an opened file as well as the different versions of the file, making it easier to track changes, revert to previous states and collaborate.</p>
 
-<h4>View history</h4>
+<h3>View history</h3>
 <p>To view the recent history of a file at the workspace click the history icon on the navbar at the left:</p>
 <ul>
   <li>To see the history of file versions go to the <strong>History</strong> tab.</li>
   <li>To see the history of item changes go to the <strong>Actions</strong> tab.</li>
 </ul>
+<figure>
+  <img src="/img/workspace-basics/history-view.webp" alt="History versions button" />
+</figure>
 
-<h5>History</h5>
+<h3>History panel</h3>
 <p>At the History panel, you can save the current version of your file, as well as access previous versions for up to 7 days.</p>
 
-<h6>Saved versions</h6>
+<h4>Restore versions</h4>
+<p>All saved versions of the file—whether manually saved, autosaved, or pinned—can be restored, reverting the file back to its state at the selected time.</p>
+<figure>
+  <img src="/img/workspace-basics/history-restore.webp" alt="Restore versions" />
+</figure>
+
+<h4>Saved versions</h4>
 <p>You can save the current version of your file by clicking the pin icon at the History tab. This will allow the version to be named and it will add it to your list of versions.</p>
+<figure>
+  <img src="/img/workspace-basics/history-save.webp" alt="Saved versions" />
+</figure>
 
-<h6>Autosaved versions</h6>
+<h4>Autosaved versions</h4>
 <p>When you start working on a file, Penpot will start to automatically save versions of that file across time so that you can later restore them as needed.</p>
-<p>In the History tab, if you click on the autosaved versions, you’ll see a list of the exact date and time when the version was automatically saved. Each version of the file can be restored, reverting the file back to its state at the selected time.</p>
+<p>In the History tab, if you click on the autosaved versions, you’ll see a list of the exact date and time when the version was automatically saved.</p>
+<figure>
+  <img src="/img/workspace-basics/history-autosaved.webp" alt="Autosaved versions" />
+</figure>
 
-<h6>Pinned versions</h6>
+<h4>Pinned versions</h4>
 <p>File versions can also be pinned. Pinning a file version will allow you to name it, making it easier to access at the History tab. Pinned file versions will be saved forever and can be renamed, restored or deleted at any time.</p>
+<figure>
+  <img src="/img/workspace-basics/history-pin.webp" alt="Pin versions" />
+</figure>
 
-<h5>Actions</h5>
+<h3>Actions panel</h3>
 <p>At the Actions panel, you have the object type (rectangle, text, image...) and type of change (New, Modified, Deleted...). If you press the item, it will be reverted to its state before that specific action was performed.</p>
 <figure>
-  <img src="/img/workspace-basics/history.webp" alt="History panel" />
+  <img src="/img/workspace-basics/history-actions.webp" alt="Actions panel" />
 </figure>
 <p class="advice">The Actions panel shows only a limited list of changes at a current browser tab session. Refreshing the browser means refreshing the history of actions as well.</p>