diff --git a/.vscodeignore b/.vscodeignore
index 6d35214..3e0c113 100644
--- a/.vscodeignore
+++ b/.vscodeignore
@@ -10,3 +10,5 @@ tsconfig.json
 **/*.map
 **/*.ts
 .vscode-test/**
+docs/**
+media/icon.svg
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 6a50d99..cbf7c70 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,6 +5,7 @@
 - `.archify` files: Archify JSON diagram sources with their own extension. They open as JSON, preview with the same button and keys, report problems, and get completion from the schema of their `diagram_type`.
 - Render to HTML and Open in Browser name the output after the diagram (`web.archify` → `web.html`).
 - `examples/hello.archify` starter diagram.
+- Marketplace icon and README screenshot.
 
 ## 0.1.0 — 2026-09-30
 
diff --git a/README.md b/README.md
index 2907c25..ef158d0 100644
--- a/README.md
+++ b/README.md
@@ -2,6 +2,8 @@
 
 View [Archify](https://github.com/tt-a1i/archify) diagrams inside VS Code. Write a diagram in a `.archify` file and see the interactive diagram next to it, updated as you type. Open rendered Archify HTML files in a viewer tab instead of a browser.
 
+![An Archify workflow diagram as shown by the preview](docs/preview.png)
+
 This is an unofficial extension. It bundles the Archify renderer (MIT, © tt-a1i) and runs it on VS Code's own Node runtime, so nothing else needs to be installed.
 
 ## Quick start
diff --git a/docs/preview.png b/docs/preview.png
new file mode 100644
index 0000000..5e9be9c
Binary files /dev/null and b/docs/preview.png differ
diff --git a/media/icon.png b/media/icon.png
new file mode 100644
index 0000000..22d9c18
Binary files /dev/null and b/media/icon.png differ
diff --git a/media/icon.svg b/media/icon.svg
new file mode 100644
index 0000000..4a0992a
--- /dev/null
+++ b/media/icon.svg
@@ -0,0 +1,23 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="256" height="256" viewBox="0 0 256 256">
+  <defs>
+    <linearGradient id="bg" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#0e7490"/>
+      <stop offset="1" stop-color="#3730a3"/>
+    </linearGradient>
+  </defs>
+  <rect x="8" y="8" width="240" height="240" rx="52" fill="url(#bg)"/>
+  <g fill="none" stroke="#e0f2fe" stroke-width="9" stroke-linecap="round" stroke-linejoin="round">
+    <path d="M78 98 V128 H178 V98"/>
+    <path d="M128 128 V160"/>
+  </g>
+  <g fill="#ffffff">
+    <rect x="42" y="54" width="72" height="46" rx="11"/>
+    <rect x="142" y="54" width="72" height="46" rx="11"/>
+    <rect x="92" y="158" width="72" height="46" rx="11" fill="#fde68a"/>
+  </g>
+  <g fill="#0e7490">
+    <rect x="56" y="72" width="44" height="9" rx="4.5"/>
+    <rect x="156" y="72" width="44" height="9" rx="4.5"/>
+  </g>
+  <rect x="106" y="176" width="44" height="9" rx="4.5" fill="#92400e"/>
+</svg>
diff --git a/package.json b/package.json
index 4924e32..103721d 100644
--- a/package.json
+++ b/package.json
@@ -5,6 +5,11 @@
   "version": "0.2.0",
   "publisher": "vscode-extensions",
   "license": "MIT",
+  "icon": "media/icon.png",
+  "galleryBanner": {
+    "color": "#0f172a",
+    "theme": "dark"
+  },
   "repository": {
     "type": "git",
     "url": "https://gitea.lego-cloud.eu/vscode-extensions/archify-vscode-ext.git"
@@ -53,7 +58,7 @@
       },
       {
         "command": "archify.renderToHtml",
-        "title": "Render to HTML File…",
+        "title": "Render to HTML File\u2026",
         "category": "Archify",
         "icon": "$(file-code)"
       },