diff --git a/docs/package.json b/docs/package.json
index ed8b31429..88ae9f344 100644
--- a/docs/package.json
+++ b/docs/package.json
@@ -17,6 +17,7 @@
   },
   "dependencies": {
     "@docusaurus/core": "3.9.2",
+    "@docusaurus/plugin-content-docs": "3.9.2",
     "@docusaurus/plugin-debug": "3.9.2",
     "@docusaurus/plugin-google-tag-manager": "3.9.2",
     "@docusaurus/preset-classic": "3.9.2",
diff --git a/docs/src/theme/DocItem/Metadata/index.js b/docs/src/theme/DocItem/Metadata/index.js
new file mode 100644
index 000000000..e6305c41f
--- /dev/null
+++ b/docs/src/theme/DocItem/Metadata/index.js
@@ -0,0 +1,19 @@
+import React from 'react';
+import { PageMetadata } from '@docusaurus/theme-common';
+import { useDoc } from '@docusaurus/plugin-content-docs/client';
+
+// The t-rex-ui DocItem/Metadata derives a per-page og:image path
+// (img/og/<title>.png) that this site doesn't ship, so every page's
+// og:image would 404. Restore the classic behavior: without a page
+// image, Docusaurus falls back to themeConfig.image (og-image.png).
+export default function DocItemMetadata() {
+  const { metadata, frontMatter, assets } = useDoc();
+  return (
+    <PageMetadata
+      title={metadata.title}
+      description={metadata.description}
+      keywords={frontMatter.keywords}
+      image={assets.image ?? frontMatter.image}
+    />
+  );
+}
\ No newline at end of file
diff --git a/docs/yarn.lock b/docs/yarn.lock
index 86e02cd43..2783ae9a3 100644
--- a/docs/yarn.lock
+++ b/docs/yarn.lock
@@ -7371,6 +7371,7 @@ __metadata:
   dependencies:
     "@docusaurus/core": "npm:3.9.2"
     "@docusaurus/module-type-aliases": "npm:3.9.2"
+    "@docusaurus/plugin-content-docs": "npm:3.9.2"
     "@docusaurus/plugin-debug": "npm:3.9.2"
     "@docusaurus/plugin-google-tag-manager": "npm:3.9.2"
     "@docusaurus/preset-classic": "npm:3.9.2"