Add structured data and mobile viewport for AI-friendly SEO (#367)

JakeSCahill · coderabbitai[bot] · web-flow · commit 8bc5f641bf10 · 2026-03-10T18:09:26.000Z
* Add structured data and mobile viewport for AI-friendly SEO

This commit improves the documentation site's discoverability and
usability for both AI crawlers and end users.

Changes:
- Add mobile viewport meta tag for responsive design
- Add JSON-LD structured data with Organization schema
- Add WebSite schema with SearchAction for site search
- Include social media links (sameAs) for knowledge graph
- Add contact information for better organization visibility

These improvements help search engines and AI assistants better
understand our site structure, content, and organization identity.

* Update src/partials/head-structured-data.hbs

Co-authored-by: coderabbitai[bot] &lt;136622811+coderabbitai[bot]@users.noreply.github.com&gt;

* Address PR feedback: fix GitHub URL and add Agentic Data Plane

- Change GitHub sameAs link to organization profile (redpanda-data)
- Update description to include 'Agentic Data Plane'
- Make WebSite schema URLs dynamic using site.url variable
- Keep Organization schema URLs hardcoded (company, not docs site)

* Add Agentic Data Plane to WebSite schema description

---------

Co-authored-by: coderabbitai[bot] &lt;136622811+coderabbitai[bot]@users.noreply.github.com&gt;
diff --git a/src/partials/head-meta.hbs b/src/partials/head-meta.hbs
@@ -1,3 +1,4 @@
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
 {{!-- Prevent old versions from being indexed by search engines --}}
 {{#if (or (is-prerelease page) site.keys.preview)}}
 <meta name="robots" content="noindex">
diff --git a/src/partials/head-structured-data.hbs b/src/partials/head-structured-data.hbs
@@ -0,0 +1,50 @@
+<script type="application/ld+json">
+{
+  "@context": "https://schema.org",
+  "@graph": [
+    {
+      "@type": "Organization",
+      "@id": "https://redpanda.com/#organization",
+      "name": "Redpanda Data",
+      "url": "https://redpanda.com",
+      "logo": {
+        "@type": "ImageObject",
+        "url": "https://redpanda.com/favicon.ico",
+        "width": 512,
+        "height": 512
+      },
+      "description": "Redpanda is a streaming data platform and Agentic Data Plane for developers. Build real-time applications without the complexity of legacy platforms.",
+      "sameAs": [
+        "https://twitter.com/redpandadata",
+        "https://www.linkedin.com/company/redpanda-data",
+        "https://github.com/redpanda-data",
+        "https://www.youtube.com/@RedpandaData",
+        "https://bsky.app/profile/redpanda.com"
+      ],
+      "contactPoint": {
+        "@type": "ContactPoint",
+        "contactType": "Customer Support",
+        "url": "https://redpanda.com/contact"
+      }
+    },
+    {
+      "@type": "WebSite",
+      "@id": "{{#with site.url}}{{{this}}}{{else}}https://docs.redpanda.com{{/with}}/#website",
+      "url": "{{#with site.url}}{{{this}}}{{else}}https://docs.redpanda.com{{/with}}",
+      "name": "Redpanda Documentation",
+      "description": "Redpanda Documentation: Guides, API references, and resources for event streaming and Agentic Data Plane.",
+      "publisher": {
+        "@id": "https://redpanda.com/#organization"
+      },
+      "potentialAction": {
+        "@type": "SearchAction",
+        "target": {
+          "@type": "EntryPoint",
+          "urlTemplate": "{{#with site.url}}{{{this}}}{{else}}https://docs.redpanda.com{{/with}}/search/?q={search_term_string}"
+        },
+        "query-input": "required name=search_term_string"
+      }
+    }
+  ]
+}
+</script>
diff --git a/src/partials/head.hbs b/src/partials/head.hbs
@@ -2,6 +2,7 @@
 {{> head-prelude}}
 {{> head-title}}
 {{> head-info}}
+{{> head-structured-data}}
 <link rel="preload" href="{{{@root.uiRootPath}}}/font/Inter-Regular.ttf" as="font" type="font/ttf" crossorigin>
 <link rel="preload" href="{{{@root.uiRootPath}}}/font/Inter-Medium.ttf" as="font" type="font/ttf" crossorigin>
 <link rel="preload" href="{{{@root.uiRootPath}}}/font/Inter-SemiBold.ttf" as="font" type="font/ttf" crossorigin>

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,4 @@`
	`1`	`+<meta name="viewport" content="width=device-width, initial-scale=1.0">`
`1`	`2`	`{{!-- Prevent old versions from being indexed by search engines --}}`
`2`	`3`	`{{#if (or (is-prerelease page) site.keys.preview)}}`
`3`	`4`	`<meta name="robots" content="noindex">`