seo: make Google show "Prisma" as the site name, not "Prisma ORM" (#8091)

ankur-arch · claude · web-flow · commit f7bdd40d72c8 · 2026-07-23T13:34:34.000+02:00
* seo: make Google show "Prisma" as the site name, not "Prisma ORM"

Searching for "prisma" returned the prisma.io homepage titled "Prisma ORM".
That string appears nowhere in the homepage's metadata — Google was rewriting
the title link, because the title it was given, "Agent Infrastructure for
TypeScript", contains no brand at all. When a title doesn't identify the site,
Google substitutes other signals, chiefly inbound anchor text, and nearly
everything linking to prisma.io calls it "Prisma ORM".

Three things were feeding the rewrite:

- The homepage title carried no brand, and page titles across the site were
  inconsistent about it — some ended in "| Prisma", most had nothing.
- Docs and blog each declared their own schema.org WebSite entity ("Prisma
  Documentation", "Prisma Blog") alongside the canonical one in apps/site, so
  the domain offered Google three competing candidates for its site name.
- Docs and blog emitted no og:site_name, leaving apps/site as the only section
  of the domain asserting the brand.

So:

- Homepage title is now brand-first, "Prisma | Agent Infrastructure for
  TypeScript", per Google's guidance for homepages.
- createPageMetadata appends "| Prisma" to any title that doesn't already
  contain it, which brands the ~30 pages that lacked it while leaving
  "Prisma ORM | Type-Safe ORM..." and friends untouched.
- Docs and blog no longer declare WebSite entities. Docs is a CollectionPage
  and the blog is a Blog, both isPartOf the one WebSite in apps/site. The docs
  node dropped its SearchAction along the way; that drove the sitelinks search
  box, which Google has retired.
- Docs and blog set og:site_name to "Prisma", matching apps/site.

Verified by rendering all three apps: the homepage titles as "Prisma | Agent
Infrastructure for TypeScript", /terms as "Terms of Service | Prisma", /orm
unchanged, and docs/blog emit a single WebSite plus og:site_name "Prisma".

Note that this only removes our own conflicting signals. Google recrawls and
re-evaluates the site name on its own schedule, so the SERP change will lag
the deploy by days to weeks.

Co-Authored-By: Claude Opus 4.8 (1M context) &lt;noreply@anthropic.com&gt;

* seo: match brand as a whole word when branding page titles

Guard withSiteName against a title that merely contains the letters
"Prisma" (a hypothetical "Prismatic…") getting treated as branded, while
still leaving titles that already carry the brand as a word untouched so
they don't become "Prisma ORM | ... | Prisma".

Co-Authored-By: Claude Opus 4.8 (1M context) &lt;noreply@anthropic.com&gt;

---------

Co-authored-by: Claude Opus 4.8 (1M context) &lt;noreply@anthropic.com&gt;
diff --git a/apps/blog/src/app/(blog)/[slug]/page.tsx b/apps/blog/src/app/(blog)/[slug]/page.tsx
@@ -333,6 +333,7 @@ export async function generateMetadata({
       canonical: withBlogBasePath(page.url),
     },
     openGraph: {
+      siteName: "Prisma",
       title,
       description,
       url: withBlogBasePath(page.url),
diff --git a/apps/blog/src/app/(blog)/author/[slug]/page.tsx b/apps/blog/src/app/(blog)/author/[slug]/page.tsx
@@ -143,6 +143,7 @@ export async function generateMetadata({
     description,
     alternates: { canonical: withBlogBasePath(`/author/${profile.slug}`) },
     openGraph: {
+      siteName: "Prisma",
       type: "website",
       title,
       description,
diff --git a/apps/blog/src/app/(blog)/page.tsx b/apps/blog/src/app/(blog)/page.tsx
@@ -33,6 +33,7 @@ export async function generateMetadata(): Promise<Metadata> {
       canonical: withBlogBasePath("/"),
     },
     openGraph: {
+      siteName: "Prisma",
       type: "website",
       title: BLOG_HOME_TITLE,
       description: BLOG_HOME_DESCRIPTION,
diff --git a/apps/blog/src/app/(blog)/series/[key]/page.tsx b/apps/blog/src/app/(blog)/series/[key]/page.tsx
@@ -143,6 +143,7 @@ export async function generateMetadata({
     description,
     alternates: { canonical: withBlogBasePath(`/series/${key}`) },
     openGraph: {
+      siteName: "Prisma",
       type: "website",
       title,
       description,
diff --git a/apps/blog/src/app/(blog)/series/page.tsx b/apps/blog/src/app/(blog)/series/page.tsx
@@ -19,6 +19,7 @@ export async function generateMetadata(): Promise<Metadata> {
     description: PAGE_DESCRIPTION,
     alternates: { canonical: withBlogBasePath("/series") },
     openGraph: {
+      siteName: "Prisma",
       type: "website",
       title,
       description: PAGE_DESCRIPTION,
diff --git a/apps/blog/src/lib/structured-data.ts b/apps/blog/src/lib/structured-data.ts
@@ -26,11 +26,17 @@ export function createBlogStructuredData() {
         ],
       },
       {
-        "@type": "WebSite",
-        "@id": `${blogUrl}#website`,
+        // The blog is a section of prisma.io, not a site of its own. It used to
+        // declare its own WebSite, which competed with the canonical one in
+        // apps/site for the site name Google shows.
+        "@type": "Blog",
+        "@id": `${blogUrl}#blog`,
         name: "Prisma Blog",
         url: blogUrl,
         description: BLOG_HOME_DESCRIPTION,
+        isPartOf: {
+          "@id": `${baseUrl}#website`,
+        },
         publisher: {
           "@id": `${baseUrl}#organization`,
         },
diff --git a/apps/docs/src/app/(docs)/(default)/[[...slug]]/page.tsx b/apps/docs/src/app/(docs)/(default)/[[...slug]]/page.tsx
@@ -126,6 +126,7 @@ export async function generateMetadata({
       canonical: withDocsBasePath(page.url),
     },
     openGraph: {
+      siteName: "Prisma",
       title,
       description,
       url: withDocsBasePath(page.url),
diff --git a/apps/docs/src/app/layout.tsx b/apps/docs/src/app/layout.tsx
@@ -66,19 +66,20 @@ export default function Layout({ children }: { children: ReactNode }) {
         <script
           type="application/ld+json"
           dangerouslySetInnerHTML={{
+            // Docs is a section of prisma.io, not a site of its own. Declaring
+            // a second WebSite here gave Google a competing candidate for the
+            // site name, so this points at the canonical one in apps/site
+            // instead. (The SearchAction it used to carry drove the sitelinks
+            // search box, which Google retired.)
             __html: JSON.stringify({
               "@context": "https://schema.org",
-              "@type": "WebSite",
+              "@type": "CollectionPage",
               name: "Prisma Documentation",
               url: "https://www.prisma.io/docs",
-              potentialAction: {
-                "@type": "SearchAction",
-                target: {
-                  "@type": "EntryPoint",
-                  urlTemplate: "https://www.prisma.io/docs?q={search_term_string}",
-                },
-                "query-input": "required name=search_term_string",
-              },
+              // @ids must match the nodes apps/site emits verbatim, which build
+              // off an origin with no trailing slash.
+              isPartOf: { "@id": "https://www.prisma.io#website" },
+              publisher: { "@id": "https://www.prisma.io#organization" },
             }),
           }}
         />
diff --git a/apps/site/src/app/(index)/page.tsx b/apps/site/src/app/(index)/page.tsx
@@ -218,7 +218,7 @@ export const metadata = createPageMetadata({
 
 const homeStructuredData = createCollectionPageStructuredData({
   path: "/",
-  name: "Agent Infrastructure for TypeScript",
+  name: SITE_HOME_TITLE,
   description: SITE_HOME_DESCRIPTION,
   items: [
     {
diff --git a/apps/site/src/app/not-found.tsx b/apps/site/src/app/not-found.tsx
@@ -3,7 +3,7 @@ import { NotFoundTracker } from "@/components/not-found-tracker";
 import type { Metadata } from "next";
 
 export const metadata: Metadata = {
-  title: "404 - Page Not Found",
+  title: "404 - Page Not Found | Prisma",
   description: "The page you were looking for could not be found.",
 };
 
diff --git a/apps/site/src/lib/page-metadata.ts b/apps/site/src/lib/page-metadata.ts
@@ -1,5 +1,6 @@
 import type { Metadata } from "next";
 import { getBaseUrl } from "@/lib/url";
+import { SITE_NAME } from "@/lib/site-metadata";
 
 type PageMetadataOptions = {
   title: string;
@@ -8,12 +9,29 @@ type PageMetadataOptions = {
   ogImage?: string;
 };
 
+/**
+ * Google rewrites a title link when the title doesn't identify the site,
+ * falling back to whatever inbound links call the page. Titles here are
+ * inconsistent about carrying the brand, so add it where it's missing rather
+ * than blanket-appending and ending up with "Prisma ORM | Prisma".
+ *
+ * The brand is matched as a whole word, so a title that already carries it
+ * ("Prisma ORM | Type-Safe ORM…", "…with Prisma & CockroachDB") is left alone,
+ * while a title that merely contains the letters ("Prismatic…") still gets it.
+ */
+const SITE_NAME_PATTERN = new RegExp(`\\b${SITE_NAME}\\b`);
+
+function withSiteName(title: string): string {
+  return SITE_NAME_PATTERN.test(title) ? title : `${title} | ${SITE_NAME}`;
+}
+
 export function createPageMetadata({
-  title,
+  title: rawTitle,
   description,
   path,
   ogImage = "/og/og-index.png",
 }: PageMetadataOptions): Metadata {
+  const title = withSiteName(rawTitle);
   const pathname = path === "/" ? "/" : path.startsWith("/") ? path : `/${path}`;
   const baseUrl = getBaseUrl();
   const url = new URL(pathname, baseUrl).toString();
diff --git a/apps/site/src/lib/site-metadata.ts b/apps/site/src/lib/site-metadata.ts
@@ -1,4 +1,15 @@
-export const SITE_HOME_TITLE = "Agent Infrastructure for TypeScript";
+/**
+ * The brand Google should show as the site name in search results. Every page
+ * title on the domain has to carry this — a title with no brand in it gets
+ * rewritten by Google using inbound anchor text instead, which is how the
+ * homepage ended up listed as "Prisma ORM".
+ */
+export const SITE_NAME = "Prisma";
+
+export const SITE_HOME_TAGLINE = "Agent Infrastructure for TypeScript";
+
+/** Brand-first, per Google's guidance for homepage titles. */
+export const SITE_HOME_TITLE = `${SITE_NAME} | ${SITE_HOME_TAGLINE}`;
 
 export const SITE_HOME_DESCRIPTION =
   "Prisma gives TypeScript and Node.js teams Prisma ORM, Prisma Postgres, and Prisma Compute: a type-safe ORM, managed Postgres, and Compute for deploying TypeScript apps, from schema to deployed app.";
diff --git a/apps/site/src/lib/structured-data.ts b/apps/site/src/lib/structured-data.ts
@@ -1,5 +1,5 @@
 import { getBaseUrl } from "@/lib/url";
-import { SITE_HOME_DESCRIPTION } from "@/lib/site-metadata";
+import { SITE_HOME_DESCRIPTION, SITE_NAME } from "@/lib/site-metadata";
 
 type FaqEntry = {
   question: string;
@@ -39,7 +39,7 @@ export function createSiteStructuredData() {
       {
         "@type": "Organization",
         "@id": `${baseUrl}#organization`,
-        name: "Prisma",
+        name: SITE_NAME,
         url: baseUrl,
         description,
         logo: absoluteUrl("/images/logo.svg"),
@@ -52,9 +52,13 @@ export function createSiteStructuredData() {
         ],
       },
       {
+        // The single WebSite entity for prisma.io. Docs and blog deliberately
+        // do not declare their own — competing WebSite nodes on one domain give
+        // Google more than one candidate for the site name.
         "@type": "WebSite",
         "@id": `${baseUrl}#website`,
-        name: "Prisma",
+        name: SITE_NAME,
+        alternateName: "Prisma.io",
         url: baseUrl,
         description,
         publisher: {

Original file line number	Diff line number	Diff line change
`@@ -218,7 +218,7 @@ export const metadata = createPageMetadata({`
`218`	`218`
`219`	`219`	`const homeStructuredData = createCollectionPageStructuredData({`
`220`	`220`	`path: "/",`
`221`		`- name: "Agent Infrastructure for TypeScript",`
	`221`	`+ name: SITE_HOME_TITLE,`
`222`	`222`	`description: SITE_HOME_DESCRIPTION,`
`223`	`223`	`items: [`
`224`	`224`	`{`