docs

Schema.org Structured Data

Add structured Schema.org data to Sanity content with typed Studio fields and Next.js JSON-LD components. Use Article, Product, FAQPage, WebSite, Organization, BreadcrumbList, and 30+ more types to describe content clearly for rich results, knowledge graphs, and AI answer surfaces.

Why Schema.org matters in the AI era

Schema.org structured data gives search engines and AI answer systems clearer entity, relationship, and page-type signals. It does not guarantee rankings or AI citations, but it makes your content easier to parse, validate, and reference when the visible page content matches the markup.

Quick Start

sanity.config.ts

import { defineConfig } from 'sanity'
import seofields from 'sanity-plugin-seofields'
import { schemaOrg } from 'sanity-plugin-seofields/schema'

export default defineConfig({
  // ...
  plugins: [
    seofields(),    // SEO fields + dashboard
    schemaOrg(),    // all 38 Schema.org types
  ],
})

Individual Plugins

Or register only the types you need:

sanity.config.ts — individual

import { defineConfig } from 'sanity'
import {
  schemaOrgWebsitePlugin,
  schemaOrgOrganizationPlugin,
  schemaOrgArticlePlugin,
  schemaOrgFAQPagePlugin,
} from 'sanity-plugin-seofields/schema'

export default defineConfig({
  // ...
  plugins: [
    schemaOrgWebsitePlugin(),
    schemaOrgOrganizationPlugin(),
    schemaOrgArticlePlugin(),
    schemaOrgFAQPagePlugin(),
  ],
})

Schema Usage

When using schemaOrg(), a combined schemaOrg array field is registered that can hold multiple Schema.org types. Add it to any document schema:

schemas/page.ts

import { defineField, defineType } from 'sanity'

export default defineType({
  name: 'page',
  title: 'Page',
  type: 'document',
  fields: [
    // ... your other fields
    defineField({
      name: 'schemaOrg',
      title: 'Schema.org Structured Data',
      type: 'schemaOrg',
    }),
  ],
})

Or use individual types directly:

Individual fields

defineField({
  name: 'schemaOrgWebsite',
  title: 'Website Schema',
  type: 'schemaOrgWebsite',
}),
defineField({
  name: 'schemaOrgOrganization',
  title: 'Organization Schema',
  type: 'schemaOrgOrganization',
}),

Rendering in Next.js

Each type has a React component that renders a valid <script type="application/ld+json"> tag:

app/layout.tsx

import {
  WebsiteSchema,
  OrganizationSchema,
  ArticleSchema,
} from 'sanity-plugin-seofields/schema/next'

export default function Layout({ data }) {
  return (
    <>
      <WebsiteSchema data={data.website} />
      <OrganizationSchema data={data.organization} />
      <ArticleSchema data={data.article} />
      {/* ... */}
    </>
  )
}

Combined Schema Array

When using schemaOrg(), a schemaOrg array field is registered that can hold multiple types. Render all of them with one component:

Combined renderer

import { SchemaOrgScripts } from 'sanity-plugin-seofields/schema/next'

// In your page component
<SchemaOrgScripts items={data.schemaOrg} />

All 38 Schema.org Types

Grouped by purpose. Click any type for fields, JSON-LD output, and usage examples.

Try the type picker →

Content & Articles

10 types

Pages, editorial, and written content.

Website

Represents an entire website — name, URL, publisher, language.

WebPage

An individual web page — name, URL, description, parent site.

Article

A news, scholarly, or blog article with author and publisher.

BlogPosting

A blog post — headline, author, date, main entity page.

NewsArticle

A news article — headline, dateline, section, publisher.

FAQPage

Frequently Asked Questions — eligible for rich results.

HowTo

Step-by-step instructions — eligible for rich results.

Recipe

A recipe — ingredients, steps, nutrition, cook time.

SocialMediaPosting

A social post — author, sharedContent, datePublished.

ProfilePage

A profile page — main entity (Person or Organization).

Commerce & Offers

8 types

Products, pricing, ratings, and reviews.

Product

A product — name, brand, image, description.

Offer

A product offer — price, currency, availability.

AggregateRating

Average rating based on multiple reviews.

Review

An individual review — author, rating, body.

Brand

A brand entity — name identification.

Service

A service — provider, area served, offers.

Restaurant

A restaurant — cuisine, price range, menu, hours.

Book

A book — author, ISBN, format, edition.

Organization & Place

12 types

People, businesses, locations, and events.

Person

A person — name, job title, social profiles, employer.

Organization

A company or organization — logo, social links, contact point.

LocalBusiness

A local business — address, phone, opening hours.

ContactPoint

Contact info — type, email, phone, languages.

PostalAddress

A structured postal/mailing address.

LegalService

A legal-services business — practice areas, hours.

JobPosting

A job listing — title, employer, location, salary.

Event

An event — date, location, organizer.

Place

A place or venue — name, address, geo.

Country

A country — name, identifier, geo.

SoftwareApplication

A software app — category, OS, offers.

WebApplication

A web-based application — URL, category.

Media & More

8 types

Images, video, music, navigation, and education.

ImageObject

An image — URL, dimensions, caption.

VideoObject

A video — thumbnail, upload date, content URL.

MusicRecording

A song or recording — artist, duration, album.

MusicAlbum

A music album — artist, tracks, release date.

Movie

A film — director, cast, duration, release.

BreadcrumbList

Navigation breadcrumbs — improves search appearance.

ItemList

An ordered list — supports rich list results.

Course

An educational course — name, provider, description.

Import Paths

sanity-plugin-seofields/schema

Sanity Studio plugins, schema factories, data types, and generator utilities.

sanity-plugin-seofields/schema/next

React components that render <script type="application/ld+json"> tags.

sanity-plugin-seofields/next

All Schema.org components + SEO meta helpers (buildSeoMeta, SeoMetaTags).

Last updated: May 27, 2026. Tested with: Sanity Studio v3, v4, and v5.

Was this page helpful?