diff --git a/docs.json b/docs.json
index 9803d1023..13113ea38 100644
--- a/docs.json
+++ b/docs.json
@@ -20,12 +20,12 @@
     "metatags": {
       "og:site_name": "LangBot Docs",
       "twitter:card": "summary_large_image",
-      "og:image": "https://langbot.app/docs/images/social/docs-v2.png",
+      "og:image": "https://langbot.app/docs/images/social/docs-v3.png",
       "og:image:width": "1200",
       "og:image:height": "630",
       "og:image:type": "image/png",
       "og:image:alt": "LangBot Docs — Build. Connect. Extend.",
-      "twitter:image": "https://langbot.app/docs/images/social/docs-v2.png",
+      "twitter:image": "https://langbot.app/docs/images/social/docs-v3.png",
       "twitter:image:alt": "LangBot Docs — Build. Connect. Extend."
     }
   },
diff --git a/images/social/docs-v3.png b/images/social/docs-v3.png
new file mode 100644
index 000000000..ef1315f9a
Binary files /dev/null and b/images/social/docs-v3.png differ
diff --git a/tests/social-preview.test.mjs b/tests/social-preview.test.mjs
index b9b41a5b7..ffd07495a 100644
--- a/tests/social-preview.test.mjs
+++ b/tests/social-preview.test.mjs
@@ -6,11 +6,11 @@ import path from "node:path";
 const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
 test("share metadata references the branded versioned preview", () => {
   for (const file of ['docs.json']) {
-    assert.ok(readFileSync(path.join(root, file), "utf8").includes('/images/social/docs-v2.png'), file);
+    assert.ok(readFileSync(path.join(root, file), "utf8").includes('/images/social/docs-v3.png'), file);
   }
 });
 test("sharing PNG is a small 1200 by 630 image", () => {
-  const file = path.join(root, 'images/social/docs-v2.png');
+  const file = path.join(root, 'images/social/docs-v3.png');
   assert.ok(existsSync(file), "branded image is present");
   const png = readFileSync(file);
   assert.equal(png.subarray(1, 4).toString(), "PNG");