diff --git a/docs/plugins/create-a-plugin.md b/docs/plugins/create-a-plugin.md
index 42fc096dbe..9a25d101b9 100644
--- a/docs/plugins/create-a-plugin.md
+++ b/docs/plugins/create-a-plugin.md
@@ -219,8 +219,9 @@ Now that everything is in place you need a <code class="language-js">manifest.js
 {
   "name": "Plugin name",
   "description": "Plugin description",
-  "code": "/plugin.js",
-  "icon": "/icon.png",
+  "version": 2,
+  "code": "plugin.js",
+  "icon": "icon.png",
   "permissions": [
     "content:read",
     "content:write",
@@ -234,6 +235,13 @@ Now that everything is in place you need a <code class="language-js">manifest.js
 }
 ```
 
+<p class="advice">
+Use <code class="language-js">"version": 2</code> when your
+<code class="language-js">code</code> and <code class="language-js">icon</code> values
+are relative paths. Version 2 resolves these assets from the manifest location.
+If omitted, Penpot treats the manifest as version 1.
+</p>
+
 ### Icon
 
 The plugin icon must be an image file. All image formats are valid, so you can use whichever format works best for your needs. Although there is no specific size requirement, it is recommended that the icon be 56x56 pixels in order to ensure its optimal appearance across all devices.
diff --git a/docs/plugins/getting-started.md b/docs/plugins/getting-started.md
index abfbc508b1..ea993640a9 100644
--- a/docs/plugins/getting-started.md
+++ b/docs/plugins/getting-started.md
@@ -131,6 +131,7 @@ The <code class="language-js">manifest.json</code> file contains the basic infor
 {
   "name": "Your plugin name",
   "description": "Your plugin description",
+  "version": 2,
   "code": "plugin.js",
   "icon": "Your icon",
   "permissions": [
@@ -147,6 +148,12 @@ The <code class="language-js">manifest.json</code> file contains the basic infor
 }
 ```
 
+<p class="advice">
+Set <code class="language-js">"version": 2</code> in your
+<code class="language-js">manifest.json</code> if you use relative paths for
+<code class="language-js">code</code> or <code class="language-js">icon</code>.
+</p>
+
 #### Properties
 
 - **Name and description**: your plugin's basic information, which will be displayed in the plugin manager modal.