// TUTORIAL

GENERATE SCHEMA MARKUP
JSON-LD FOR 30+ TYPES

How to detect, validate, and generate Schema.org structured data using Claude SEO. From Organization to Product to VideoObject, all from a single command in your terminal.

PUBLISHED MARCH 25, 2026 // UPDATED JULY 21, 2026 // BY DANIEL AGRICI // 6 MIN READ

$

/seo schema https://your-site.com

Schema markup is a standardized vocabulary for describing entities and page content in a machine-readable form. Google uses supported structured data to understand eligible features such as products, articles, events, and breadcrumbs. Valid markup can make a page eligible for a feature, but it does not guarantee a rich result, ranking improvement, or citation in an AI-generated answer.

The /seo schema command in Claude SEO handles three things: detecting existing schema on your pages, validating it against Google's current requirements, and generating new JSON-LD markup for schema types you are missing. It supports over 30 active schema types.

What is JSON-LD and why does Google prefer it?

JSON-LD is a JavaScript Object Notation format for expressing structured data as a self-contained block rather than as attributes woven through visible HTML. Google's structured data introduction recommends JSON-LD because the markup can sit in one script block. The vocabulary comes from Schema.org. Search engines decide which vocabulary and properties they consume, so validate against both Schema.org and the documentation for the specific search feature you want to support.

How do you generate schema markup with Claude SEO?

The schema skill operates in three modes. When you point it at a URL, it runs all three automatically.

1. Detection

Claude SEO scans your page source for structured data in all three formats:

JSON-LD - <script type="application/ld+json"> blocks (Google's preferred format)
Microdata - HTML attributes like itemscope and itemprop
RDFa - HTML attributes like typeof and property

JSON-LD is the recommended format because it lives in a separate script tag. You do not need to modify your HTML structure, and it is easier to maintain, debug, and update.

2. Validation

Found markup is validated against Google's supported rich result types. Claude SEO checks for common errors that break rich results:

Missing @context declaration
Invalid @type values
Wrong data types (string where number expected, etc.)
Placeholder text left in production markup
Relative URLs where absolute URLs are required
Invalid date formats (ISO 8601 is required)
Deprecated schema types still in use

3. Generation

Based on your page content, Claude SEO identifies which schema types are appropriate and generates ready-to-use JSON-LD. It analyzes your page to determine the type (product page, blog post, local business, etc.) and fills in as many properties as it can from visible content. Properties it cannot determine are marked as placeholders for you to fill.

What schema types does Claude SEO support?

Claude SEO separates active types, specialized types, types with no current Google Search rich-result surface, and retired rich-result integrations. Here is the reviewed status as of July 2026:

Status	Schema Types
ACTIVE	Organization, LocalBusiness, SoftwareApplication, WebApplication, Product, ProductGroup, Offer, Service, Article, BlogPosting, NewsArticle, Review, AggregateRating, BreadcrumbList, WebSite, WebPage, Person, ProfilePage, ContactPage, VideoObject, ImageObject, Event, JobPosting, Course, QAPage, DiscussionForumPosting
SPECIALIZED	BroadcastEvent, Clip, SeekToAction, SoftwareSourceCode
NO GOOGLE SEARCH RICH RESULT	FAQPage (retired for all sites May 7, 2026; keep only when useful), Dataset (supported by Google Dataset Search)
RETIRED INTEGRATIONS	HowTo, SpecialAnnouncement, CourseInfo, EstimatedSalary, LearningVideo, ClaimReview, VehicleListing, Practice Problem

Which schema types should you prioritize?

With 30+ supported types, it helps to know which ones actually matter for your specific site. The right schema strategy depends on your business model. Here is a practical breakdown by site type.

SaaS and software products

Start with Organization for the publisher, SoftwareApplication when the page describes an application, and BreadcrumbList for navigational hierarchy. If you have a free tier, include truthful Offer properties such as "price": "0" and "priceCurrency": "USD". Do not add FAQPage for a Google rich-result benefit because that surface has been retired.

Local businesses

Use LocalBusiness with the most accurate subtype and properties that match visible content. Include address, hours, and coordinates when they are truthful and relevant. Add AggregateRating only when the reviews and ratings meet Google's policies. Structured data provides context for eligible features but does not guarantee local-pack placement.

E-commerce sites

Product and Offer should reflect the product and purchasable offer shown on the page. Include accurate availability, price currency, and price data. Add AggregateRating only for eligible reviews that users can see, and use BreadcrumbList for the real category path.

Publishers and blogs

Use Article or BlogPosting when it accurately describes the page. Include truthful publication and modification dates, a resolvable author URL, and a representative image. Author markup helps identify who created the content, but it is not a numeric E-E-A-T score or a substitute for visible authorship and expertise.

Agencies and service businesses

Organization can identify the provider. Add Service for services that are actually described on the page, with truthful provider, areaServed, serviceType, and description properties. Review markup must follow Google's review policies. FAQPage no longer produces Google rich results for any site.

Claude SEO automatically detects your site type and recommends the most relevant schema types when you run /seo schema. You do not need to memorize these lists.

Example JSON-LD outputs

Here are three common schema types that Claude SEO generates, with all required and recommended properties included.

Organization

{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Your Company Name",
  "url": "https://your-site.com",
  "logo": "https://your-site.com/logo.png",
  "contactPoint": {
    "@type": "ContactPoint",
    "telephone": "+1-555-000-0000",
    "contactType": "customer service"
  },
  "sameAs": [
    "https://www.facebook.com/yourpage",
    "https://www.linkedin.com/company/yourcompany",
    "https://twitter.com/yourhandle"
  ]
}

LocalBusiness

{
  "@context": "https://schema.org",
  "@type": "LocalBusiness",
  "name": "Your Business Name",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "123 Main Street",
    "addressLocality": "Your City",
    "addressRegion": "CA",
    "postalCode": "90210",
    "addressCountry": "US"
  },
  "telephone": "+1-555-000-0000",
  "openingHours": "Mo-Fr 09:00-17:00",
  "geo": {
    "@type": "GeoCoordinates",
    "latitude": "34.0522",
    "longitude": "-118.2437"
  }
}

Article / BlogPosting

{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Your Article Title",
  "author": {
    "@type": "Person",
    "name": "Author Name"
  },
  "datePublished": "2026-03-25",
  "dateModified": "2026-07-20",
  "image": "https://your-site.com/article-image.jpg",
  "publisher": {
    "@type": "Organization",
    "name": "Your Publication",
    "logo": {
      "@type": "ImageObject",
      "url": "https://your-site.com/logo.png"
    }
  }
}

What changed with schema markup in 2025 and 2026?

Per Google's December 2025 JavaScript SEO guidance, structured data injected via JavaScript may face delayed processing. For time-sensitive markup, especially Product and Offer types used in e-commerce, include your JSON-LD in the initial server-rendered HTML rather than injecting it with JavaScript after page load.

Product schema now supports Certification markup as of April 2025, which is useful for products with eco-labels, safety certifications, or industry compliance badges.

If Claude SEO detects a deprecated schema type on your site, it flags the type with its retirement date and recommends the current replacement or advises removal if no replacement exists.

What files does the schema command produce?

Running /seo schema produces two files:

SCHEMA-REPORT.md - detection and validation results with a table showing each found schema block, its type, status, and any issues
generated-schema.json - ready-to-use JSON-LD snippets that you can paste directly into your page's <head> section

The schema skill reference page has full documentation on all output formats, error handling, and edge cases.

Pairing with the technical audit

Structured data is one of the 9 categories in the technical SEO audit. The technical audit gives you a high-level pass/warn/fail status for structured data presence. The schema skill goes deeper with full validation, generation, and type-specific recommendations. For the most thorough analysis, run both.

// FAQ

FREQUENTLY ASKED QUESTIONS

What schema markup format does Claude SEO recommend?

Claude SEO recommends JSON-LD as the primary format for structured data. This is Google's stated preference. JSON-LD is easier to implement in a separate script block and is usually simpler to maintain than Microdata or RDFa.

How many schema types does Claude SEO support?

Claude SEO supports more than 30 active or specialized schema types, including Organization, LocalBusiness, SoftwareApplication, Product, Offer, Article, BlogPosting, BreadcrumbList, Person, VideoObject, Event, Course, DiscussionForumPosting, BroadcastEvent, Clip, SeekToAction, and SoftwareSourceCode.

Which schema types no longer produce Google rich results?

Google retired rich-result support for HowTo, SpecialAnnouncement, CourseInfo, EstimatedSalary, LearningVideo, ClaimReview, VehicleListing, Practice Problem, and FAQPage. FAQPage rich results ended for all sites on May 7, 2026. Dataset was not retired and remains supported by Google Dataset Search.

Can Claude SEO detect existing schema on my pages?

Yes. Claude SEO scans page source for JSON-LD script blocks, Microdata attributes, and RDFa attributes. It then checks syntax, property types, URLs, dates, placeholders, and whether each type is supported by the relevant Google search feature.

// RELATED

GENERATE SCHEMA MARKUP
JSON-LD FOR 30+ TYPES

What is JSON-LD and why does Google prefer it?

How do you generate schema markup with Claude SEO?

1. Detection

2. Validation

3. Generation

What schema types does Claude SEO support?

Which schema types should you prioritize?

SaaS and software products

Local businesses

E-commerce sites

Publishers and blogs

Agencies and service businesses

Example JSON-LD outputs

Organization

LocalBusiness

Article / BlogPosting

What changed with schema markup in 2025 and 2026?

What files does the schema command produce?

Pairing with the technical audit

FREQUENTLY ASKED QUESTIONS

KEEP READING

GENERATE YOUR SCHEMA
IN 30 SECONDS.

GENERATE SCHEMA MARKUPJSON-LD FOR 30+ TYPES

What is JSON-LD and why does Google prefer it?

How do you generate schema markup with Claude SEO?

1. Detection

2. Validation

3. Generation

What schema types does Claude SEO support?

Which schema types should you prioritize?

SaaS and software products

Local businesses

E-commerce sites

Publishers and blogs

Agencies and service businesses

Example JSON-LD outputs

Organization

LocalBusiness

Article / BlogPosting

What changed with schema markup in 2025 and 2026?

What files does the schema command produce?

Pairing with the technical audit

FREQUENTLY ASKED QUESTIONS

KEEP READING

SCHEMA MARKUP SKILL

TECHNICAL SEO TUTORIAL

TECHNICAL SEO SKILL

GENERATE YOUR SCHEMAIN 30 SECONDS.

GENERATE SCHEMA MARKUP
JSON-LD FOR 30+ TYPES

GENERATE YOUR SCHEMA
IN 30 SECONDS.