From bef2917e4c2ad37e1001ed9bcfaece11abef16b6 Mon Sep 17 00:00:00 2001
From: vfanucci <vfanucci@kestra.io>
Date: Tue, 19 May 2026 09:31:44 +0200
Subject: [PATCH 1/3] seo: add SoftwareApplication schema on homepage,
 enterprise, pricing, features

Adds a reusable SchemaSoftwareApplication.astro component and injects it
on the four highest-traffic product pages. Gives AI agents and search
crawlers a machine-parseable description of Kestra as a software product,
including category, license, supported platforms, and offers per tier.

Identified as priority 1 in the Agents Taskforce Pillar 1 audit.
---
 .../common/SchemaSoftwareApplication.astro    | 65 +++++++++++++++++++
 src/pages/enterprise/index.astro              |  8 +++
 src/pages/features/index.astro                |  7 ++
 src/pages/index.astro                         |  6 ++
 src/pages/pricing/index.astro                 |  5 ++
 5 files changed, 91 insertions(+)
 create mode 100644 src/components/common/SchemaSoftwareApplication.astro

diff --git a/src/components/common/SchemaSoftwareApplication.astro b/src/components/common/SchemaSoftwareApplication.astro
new file mode 100644
index 00000000000..b70ef0185ed
--- /dev/null
+++ b/src/components/common/SchemaSoftwareApplication.astro
@@ -0,0 +1,65 @@
+---
+interface Props {
+    name?: string
+    description?: string
+    url?: string
+}
+
+const { name, description, url } = Astro.props
+
+const canonicalUrl =
+    url ?? new URL(Astro.url.pathname, Astro.site ?? "https://kestra.io").toString().replace(/\/$/, "")
+
+const schema = {
+    "@context": "https://schema.org",
+    "@type": "SoftwareApplication",
+    "@id": "https://kestra.io/#software",
+    "name": name ?? "Kestra",
+    "url": canonicalUrl,
+    "description":
+        description ??
+        "Open-source workflow orchestration platform for data pipelines, infrastructure automation, and AI workflows. YAML-native, language-agnostic, 1200+ plugins.",
+    "applicationCategory": "DeveloperApplication",
+    "applicationSubCategory": "Workflow Orchestration",
+    "operatingSystem": "Linux, macOS, Windows, Docker, Kubernetes",
+    "softwareVersion": "1.0",
+    "downloadUrl": "https://github.com/kestra-io/kestra",
+    "author": { "@id": "https://kestra.io/#organization" },
+    "publisher": { "@id": "https://kestra.io/#organization" },
+    "license": "https://www.apache.org/licenses/LICENSE-2.0",
+    "offers": [
+        {
+            "@type": "Offer",
+            "name": "Kestra Open Source",
+            "price": "0",
+            "priceCurrency": "USD",
+            "availability": "https://schema.org/InStock",
+            "url": "https://github.com/kestra-io/kestra",
+        },
+        {
+            "@type": "Offer",
+            "name": "Kestra Cloud",
+            "priceSpecification": {
+                "@type": "UnitPriceSpecification",
+                "priceType": "https://schema.org/InvoicePrice",
+                "description": "Pay only for what you use",
+            },
+            "availability": "https://schema.org/InStock",
+            "url": "https://kestra.io/pricing",
+        },
+        {
+            "@type": "Offer",
+            "name": "Kestra Enterprise Edition",
+            "priceSpecification": {
+                "@type": "UnitPriceSpecification",
+                "priceType": "https://schema.org/InvoicePrice",
+                "description": "Annual subscription — contact sales",
+            },
+            "availability": "https://schema.org/InStock",
+            "url": "https://kestra.io/demo",
+        },
+    ],
+}
+---
+
+<script type="application/ld+json" set:html={JSON.stringify(schema)} />
diff --git a/src/pages/enterprise/index.astro b/src/pages/enterprise/index.astro
index b9fc34a4b35..f165f6388fc 100644
--- a/src/pages/enterprise/index.astro
+++ b/src/pages/enterprise/index.astro
@@ -1,5 +1,6 @@
 ---
 import Layout from "~/components/layout.astro"
+import SchemaSoftwareApplication from "~/components/common/SchemaSoftwareApplication.astro"
 
 import Hero from "~/components/enterprise/Hero.vue"
 import SeeHow from "~/components/common/SeeHow.astro"
@@ -39,6 +40,13 @@ const STATS = [
 ---
 
 <Layout {title} {description} headerTheme="lightText">
+    <Fragment slot="head">
+        <SchemaSoftwareApplication
+            name="Kestra Enterprise Edition"
+            description="Kestra Enterprise is a workflow orchestration platform for engineering teams running mission-critical operations at scale. Built-in governance, enterprise security, SSO, RBAC, audit logs, and horizontal scalability. Self-hosted or managed."
+            url="https://kestra.io/enterprise"
+        />
+    </Fragment>
     <Hero client:load />
     <div class="enterprise">
         <ScrollSpy client:load />
diff --git a/src/pages/features/index.astro b/src/pages/features/index.astro
index abbeb292bb6..015001f7b64 100644
--- a/src/pages/features/index.astro
+++ b/src/pages/features/index.astro
@@ -1,6 +1,7 @@
 ---
 import Faq from "~/components/common/Faq.vue"
 import Layout from "~/components/layout.astro"
+import SchemaSoftwareApplication from "~/components/common/SchemaSoftwareApplication.astro"
 import Run from "~/components/features/core/Run.astro"
 import Stacked from "~/components/common/Stacked.astro"
 import Intro from "~/components/features/core/Intro.astro"
@@ -49,6 +50,12 @@ const items = [
 ---
 
 <Layout {title} {description} headerTheme="lightText">
+    <Fragment slot="head">
+        <SchemaSoftwareApplication
+            description="Kestra orchestrates data pipelines, infrastructure automation, and AI workflows. YAML-native, language-agnostic, 1200+ plugins. Built for teams that run critical operations at scale."
+            url="https://kestra.io/features"
+        />
+    </Fragment>
     <div class="core">
         <Intro />
         <Simple />
diff --git a/src/pages/index.astro b/src/pages/index.astro
index 3cc1be9f8d5..269a4ced075 100644
--- a/src/pages/index.astro
+++ b/src/pages/index.astro
@@ -1,5 +1,6 @@
 ---
 import Layout from "~/components/layout.astro"
+import SchemaSoftwareApplication from "~/components/common/SchemaSoftwareApplication.astro"
 import Hero from "~/components/home/Hero.astro"
 import Comparison from "~/components/home/Comparison.astro"
 import Stacked from "~/components/common/Stacked.astro"
@@ -16,6 +17,11 @@ const totalPlugins = await fetchTotalPluginsCount()
 ---
 
 <Layout headerTheme="darkHeader">
+    <Fragment slot="head">
+        <SchemaSoftwareApplication
+            url="https://kestra.io"
+        />
+    </Fragment>
     <div class="home-page">
         <Hero />
         <Comparison />
diff --git a/src/pages/pricing/index.astro b/src/pages/pricing/index.astro
index 1ebcd5ed5c5..9740354154a 100644
--- a/src/pages/pricing/index.astro
+++ b/src/pages/pricing/index.astro
@@ -1,5 +1,6 @@
 ---
 import Layout from "~/components/layout.astro"
+import SchemaSoftwareApplication from "~/components/common/SchemaSoftwareApplication.astro"
 import Header from "~/components/price/Header.astro"
 import HostSwitcher from "~/components/price/HostSwitcher.astro"
 import PriceGrid from "~/components/price/PriceGrid.astro"
@@ -78,6 +79,10 @@ const pricingSchema = {
             type="application/ld+json"
             set:html={JSON.stringify(pricingSchema)}
         />
+        <SchemaSoftwareApplication
+            description="Compare Kestra plans. Start free and self-hosted with Open Source, scale with managed Cloud, or deploy Enterprise Edition for mission-critical workloads at scale."
+            url="https://kestra.io/pricing"
+        />
     </Fragment>
     <div class="cont">
         <Header>

From 1b4e1153d1de744f872b22d1c465bd5e0d79b754 Mon Sep 17 00:00:00 2001
From: vfanucci <vfanucci@kestra.io>
Date: Fri, 5 Jun 2026 14:42:48 +0200
Subject: [PATCH 2/3] fix(schema): address @id collision and stale
 softwareVersion (Piyush review)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Make SchemaSoftwareApplication @id parameterizable via prop (default
  remains #software for the home page).
- Enterprise page now declares a distinct entity @id=#enterprise-edition
  with isVariantOf -> #software, so JSON-LD parsers no longer see four
  contradictory definitions sharing the same @id.
- Remove the component from /pricing (already covered by the page-level
  Product+Offer pricingSchema) and /features (no unique entity to declare).
- Drop the hardcoded "softwareVersion": "1.0" — stale value that drifts
  from the real Kestra release. Field is optional and best omitted.
- Tighten operatingSystem to actual OSes (Linux, macOS, Windows). Docker
  and Kubernetes are deployment targets, not operating systems.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
---
 .../common/SchemaSoftwareApplication.astro        | 15 ++++++++++-----
 src/pages/enterprise/index.astro                  |  2 ++
 src/pages/features/index.astro                    |  7 -------
 src/pages/pricing/index.astro                     |  5 -----
 4 files changed, 12 insertions(+), 17 deletions(-)

diff --git a/src/components/common/SchemaSoftwareApplication.astro b/src/components/common/SchemaSoftwareApplication.astro
index b70ef0185ed..ae31eac6e74 100644
--- a/src/components/common/SchemaSoftwareApplication.astro
+++ b/src/components/common/SchemaSoftwareApplication.astro
@@ -1,19 +1,21 @@
 ---
 interface Props {
+    id?: string
     name?: string
     description?: string
     url?: string
+    isVariantOf?: string
 }
 
-const { name, description, url } = Astro.props
+const { id, name, description, url, isVariantOf } = Astro.props
 
 const canonicalUrl =
     url ?? new URL(Astro.url.pathname, Astro.site ?? "https://kestra.io").toString().replace(/\/$/, "")
 
-const schema = {
+const schema: Record<string, unknown> = {
     "@context": "https://schema.org",
     "@type": "SoftwareApplication",
-    "@id": "https://kestra.io/#software",
+    "@id": id ?? "https://kestra.io/#software",
     "name": name ?? "Kestra",
     "url": canonicalUrl,
     "description":
@@ -21,8 +23,7 @@ const schema = {
         "Open-source workflow orchestration platform for data pipelines, infrastructure automation, and AI workflows. YAML-native, language-agnostic, 1200+ plugins.",
     "applicationCategory": "DeveloperApplication",
     "applicationSubCategory": "Workflow Orchestration",
-    "operatingSystem": "Linux, macOS, Windows, Docker, Kubernetes",
-    "softwareVersion": "1.0",
+    "operatingSystem": "Linux, macOS, Windows",
     "downloadUrl": "https://github.com/kestra-io/kestra",
     "author": { "@id": "https://kestra.io/#organization" },
     "publisher": { "@id": "https://kestra.io/#organization" },
@@ -60,6 +61,10 @@ const schema = {
         },
     ],
 }
+
+if (isVariantOf) {
+    schema.isVariantOf = { "@id": isVariantOf }
+}
 ---
 
 <script type="application/ld+json" set:html={JSON.stringify(schema)} />
diff --git a/src/pages/enterprise/index.astro b/src/pages/enterprise/index.astro
index f165f6388fc..29cd8eb238f 100644
--- a/src/pages/enterprise/index.astro
+++ b/src/pages/enterprise/index.astro
@@ -42,9 +42,11 @@ const STATS = [
 <Layout {title} {description} headerTheme="lightText">
     <Fragment slot="head">
         <SchemaSoftwareApplication
+            id="https://kestra.io/#enterprise-edition"
             name="Kestra Enterprise Edition"
             description="Kestra Enterprise is a workflow orchestration platform for engineering teams running mission-critical operations at scale. Built-in governance, enterprise security, SSO, RBAC, audit logs, and horizontal scalability. Self-hosted or managed."
             url="https://kestra.io/enterprise"
+            isVariantOf="https://kestra.io/#software"
         />
     </Fragment>
     <Hero client:load />
diff --git a/src/pages/features/index.astro b/src/pages/features/index.astro
index 015001f7b64..abbeb292bb6 100644
--- a/src/pages/features/index.astro
+++ b/src/pages/features/index.astro
@@ -1,7 +1,6 @@
 ---
 import Faq from "~/components/common/Faq.vue"
 import Layout from "~/components/layout.astro"
-import SchemaSoftwareApplication from "~/components/common/SchemaSoftwareApplication.astro"
 import Run from "~/components/features/core/Run.astro"
 import Stacked from "~/components/common/Stacked.astro"
 import Intro from "~/components/features/core/Intro.astro"
@@ -50,12 +49,6 @@ const items = [
 ---
 
 <Layout {title} {description} headerTheme="lightText">
-    <Fragment slot="head">
-        <SchemaSoftwareApplication
-            description="Kestra orchestrates data pipelines, infrastructure automation, and AI workflows. YAML-native, language-agnostic, 1200+ plugins. Built for teams that run critical operations at scale."
-            url="https://kestra.io/features"
-        />
-    </Fragment>
     <div class="core">
         <Intro />
         <Simple />
diff --git a/src/pages/pricing/index.astro b/src/pages/pricing/index.astro
index 9740354154a..1ebcd5ed5c5 100644
--- a/src/pages/pricing/index.astro
+++ b/src/pages/pricing/index.astro
@@ -1,6 +1,5 @@
 ---
 import Layout from "~/components/layout.astro"
-import SchemaSoftwareApplication from "~/components/common/SchemaSoftwareApplication.astro"
 import Header from "~/components/price/Header.astro"
 import HostSwitcher from "~/components/price/HostSwitcher.astro"
 import PriceGrid from "~/components/price/PriceGrid.astro"
@@ -79,10 +78,6 @@ const pricingSchema = {
             type="application/ld+json"
             set:html={JSON.stringify(pricingSchema)}
         />
-        <SchemaSoftwareApplication
-            description="Compare Kestra plans. Start free and self-hosted with Open Source, scale with managed Cloud, or deploy Enterprise Edition for mission-critical workloads at scale."
-            url="https://kestra.io/pricing"
-        />
     </Fragment>
     <div class="cont">
         <Header>

From 00cd319bc4ec553f5dbe2faa29dc5453efd439e9 Mon Sep 17 00:00:00 2001
From: vfanucci <vfanucci@kestra.io>
Date: Mon, 8 Jun 2026 10:22:42 +0200
Subject: [PATCH 3/3] fix(schema): replace broken Product schema on /pricing
 with SchemaSoftwareApplication; add to /features
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The previous decision to leave the existing Product+Offer block on /pricing
was based on the assumption it already covered the page. Google Rich
Results Test shows otherwise: the Product schema triggers Merchant Listing
validation rules (image, priceValidUntil, hasMerchantReturnPolicy,
shippingDetails), producing 6 errors — none of which apply to a SaaS
pricing page.

- /pricing: drop the inline pricingSchema (3x Product) and emit the
  canonical #software entity via SchemaSoftwareApplication. The component's
  built-in offers array already declares all three tiers (Open Source,
  Cloud, Enterprise), so no information is lost and Google validates
  cleanly under SoftwareApplication rules.
- /features: add SchemaSoftwareApplication so the page is no longer
  schema-silent (was only emitting BreadcrumbList + Organization).
- Component: bump default description from "1200+ plugins" to "1400+
  plugins" to match the live homepage copy.

Completes the original PR scope (homepage + enterprise + pricing +
features) and eliminates the Merchant Listing validation errors.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
---
 .../common/SchemaSoftwareApplication.astro    |  2 +-
 src/pages/features/index.astro                |  4 ++
 src/pages/pricing/index.astro                 | 68 +------------------
 3 files changed, 8 insertions(+), 66 deletions(-)

diff --git a/src/components/common/SchemaSoftwareApplication.astro b/src/components/common/SchemaSoftwareApplication.astro
index ae31eac6e74..bdbcf145233 100644
--- a/src/components/common/SchemaSoftwareApplication.astro
+++ b/src/components/common/SchemaSoftwareApplication.astro
@@ -20,7 +20,7 @@ const schema: Record<string, unknown> = {
     "url": canonicalUrl,
     "description":
         description ??
-        "Open-source workflow orchestration platform for data pipelines, infrastructure automation, and AI workflows. YAML-native, language-agnostic, 1200+ plugins.",
+        "Open-source workflow orchestration platform for data pipelines, infrastructure automation, and AI workflows. YAML-native, language-agnostic, 1400+ plugins.",
     "applicationCategory": "DeveloperApplication",
     "applicationSubCategory": "Workflow Orchestration",
     "operatingSystem": "Linux, macOS, Windows",
diff --git a/src/pages/features/index.astro b/src/pages/features/index.astro
index abbeb292bb6..84c38b362e3 100644
--- a/src/pages/features/index.astro
+++ b/src/pages/features/index.astro
@@ -1,6 +1,7 @@
 ---
 import Faq from "~/components/common/Faq.vue"
 import Layout from "~/components/layout.astro"
+import SchemaSoftwareApplication from "~/components/common/SchemaSoftwareApplication.astro"
 import Run from "~/components/features/core/Run.astro"
 import Stacked from "~/components/common/Stacked.astro"
 import Intro from "~/components/features/core/Intro.astro"
@@ -49,6 +50,9 @@ const items = [
 ---
 
 <Layout {title} {description} headerTheme="lightText">
+    <Fragment slot="head">
+        <SchemaSoftwareApplication url="https://kestra.io/features" />
+    </Fragment>
     <div class="core">
         <Intro />
         <Simple />
diff --git a/src/pages/pricing/index.astro b/src/pages/pricing/index.astro
index 1ebcd5ed5c5..b68a3c88ee1 100644
--- a/src/pages/pricing/index.astro
+++ b/src/pages/pricing/index.astro
@@ -1,5 +1,6 @@
 ---
 import Layout from "~/components/layout.astro"
+import SchemaSoftwareApplication from "~/components/common/SchemaSoftwareApplication.astro"
 import Header from "~/components/price/Header.astro"
 import HostSwitcher from "~/components/price/HostSwitcher.astro"
 import PriceGrid from "~/components/price/PriceGrid.astro"
@@ -10,74 +11,11 @@ import PriceQuote from "~/components/price/PriceQuote.vue"
 const title = "Kestra Pricing: Open Source, Cloud & Enterprise Plans"
 const description =
     "Choose the right plan for your needs. Start with the Open Source version and scale with the Enterprise Edition of Kestra."
-
-const pricingSchema = {
-    "@context": "https://schema.org",
-    "@graph": [
-        {
-            "@type": "Product",
-            "@id": "https://kestra.io/pricing#open-source",
-            "name": "Kestra Open Source",
-            "url": "https://kestra.io/pricing",
-            "description":
-                "Self-hosted orchestration platform with 1,200+ plugins, unlimited flows and executions, AI Copilot, event-driven scheduling, and multi-cloud deployment.",
-            "brand": { "@id": "https://kestra.io/#organization" },
-            "offers": {
-                "@type": "Offer",
-                "price": "0",
-                "priceCurrency": "USD",
-                "availability": "https://schema.org/InStock",
-                "url": "https://github.com/kestra-io/kestra",
-            },
-        },
-        {
-            "@type": "Product",
-            "@id": "https://kestra.io/pricing#cloud",
-            "name": "Kestra Cloud",
-            "url": "https://kestra.io/pricing",
-            "description":
-                "Fully managed Kestra platform with automatic scaling, built-in security, enterprise plugins, SOC2 compliance, and pay-as-you-scale pricing.",
-            "brand": { "@id": "https://kestra.io/#organization" },
-            "offers": {
-                "@type": "Offer",
-                "priceSpecification": {
-                    "@type": "UnitPriceSpecification",
-                    "priceType": "https://schema.org/InvoicePrice",
-                    "description": "Pay only for what you use",
-                },
-                "availability": "https://schema.org/InStock",
-                "url": "https://kestra.io/pricing",
-            },
-        },
-        {
-            "@type": "Product",
-            "@id": "https://kestra.io/pricing#enterprise",
-            "name": "Kestra Enterprise Edition",
-            "url": "https://kestra.io/pricing",
-            "description":
-                "Enterprise-grade orchestration with SSO, LDAP/SCIM, custom RBAC, audit logs, worker groups, multi-tenant support, AI Copilot with any LLM, and enterprise SLA.",
-            "brand": { "@id": "https://kestra.io/#organization" },
-            "offers": {
-                "@type": "Offer",
-                "priceSpecification": {
-                    "@type": "UnitPriceSpecification",
-                    "priceType": "https://schema.org/InvoicePrice",
-                    "description": "Annual subscription — contact sales",
-                },
-                "availability": "https://schema.org/InStock",
-                "url": "https://kestra.io/demo",
-            },
-        },
-    ],
-}
 ---
 
 <Layout {title} {description}>
     <Fragment slot="head">
-        <script
-            type="application/ld+json"
-            set:html={JSON.stringify(pricingSchema)}
-        />
+        <SchemaSoftwareApplication url="https://kestra.io/pricing" />
     </Fragment>
     <div class="cont">
         <Header>
@@ -94,4 +32,4 @@ const pricingSchema = {
     .cont {
         overflow: clip;
     }
-</style>
\ No newline at end of file
+</style>