Core format · included on every plan

Schema JSON (JSON-LD)

Structured data, the way Google and AI engines prefer it.

5 / 5GEO score
JSON · Geordyschema.json
Why it matters

JSON-LD lets you embed a machine-readable graph of typed entities (Article, Product, Person, Organization, FAQ, Event) inside a single `<script type="application/ld+json">` tag. Search engines and LLM-powered answer engines lift this directly to populate rich results, knowledge panels, and answer citations - it's the format Google explicitly recommends over Microdata or RDFa.

Geordy generates this format for every page on your site that warrants it - auto-detected by page type, served from your subdomain, and refreshed on the cadence below.

Sample outputschema.json
{
  "@context": "https://schema.org",
  "@type": "SoftwareApplication",
  "name": "Geordy",
  "applicationCategory": "BusinessApplication",
  "description": "AI optimization platform for generative search engines"
}
Get it right

How to make this format work for AI.

DoBest practices
  • Use `@context: "https://schema.org"` and pick the most specific type (e.g. `TechArticle`, not just `Article`).
  • Mark up only content that is actually visible to users on the page - Google penalizes hidden or contradictory schema.
  • Cross-link entities with `@id` URIs so Person -> worksFor -> Organization forms a real graph instead of disconnected blobs.
  • Validate every page with both Google's Rich Results Test and Schema.org's validator before shipping.
AvoidCommon pitfalls
  • Stuffing schema with data not present on the page (e.g. fake reviews, ratings) - triggers manual actions.
  • Using deprecated or made-up properties; if it isn't on schema.org or pending.schema.org it won't be parsed.
  • Multiple conflicting JSON-LD blocks on one page (e.g. two Organization nodes with different logos) confuse parsers.
Where it shines

Use cases, scored for AI visibility.

Rich search resultsGEO 5/5
Knowledge graph entity definitionGEO 5/5
AI citation groundingGEO 5/5
Used in production by

Real sites already shipping Schema JSON (JSON-LD).

Working with it

Tools & resources for Schema JSON (JSON-LD).

The trade-offs
Strengths
  • Modern standard recommended by Google
  • Enables rich search results and knowledge graph inclusion
  • Single source of truth for entity data
  • Parsed natively by every major search and AI engine
Spec sheet
Filename
schema.json
Refresh cadence
daily
Released
2014 · Schema.org / W3C
Written forGoogle SearchBingVoice assistantsAI citation systemsKnowledge graph systems

Written for these readers. Which of them actually request it is measured, not assumed: see how we measure.

Documented support
Observed requests

Share of eligible sites where each crawler requested this file at least once, over the 90 days to 11 November 2026.

Schema JSON (JSON-LD): observed requests by crawler
CrawlerEvidenceSites with a requestMedian requests per site per dayRank
OAI-SearchBotEstablished patternunder 5%0Similar to others
ChatGPT-UserEstablished patternunder 5%0Similar to others
GPTBotEstablished patternunder 5%0Similar to others
ClaudeBotEstablished patternunder 5%0Similar to others
PerplexityBotEstablished patternunder 5%0Similar to others
bingbotEstablished patternunder 5%0Similar to others
Claude-SearchBotEstablished pattern0%0Similar to others
Claude-UserEstablished pattern0%0Similar to others
Claude-WebEstablished pattern0%0Similar to others
anthropic-aiEstablished pattern0%0Similar to others
Perplexity-UserEstablished pattern0%0Similar to others
Google-CloudVertexBotEstablished pattern0%0Similar to others
GooglebotEstablished pattern0%0Similar to others
ApplebotEstablished pattern0%0Similar to others
Meta-ExternalAgentEstablished pattern0%0Similar to others
Meta-ExternalFetcherEstablished pattern0%0Similar to others
FacebookBotEstablished pattern0%0Similar to others
CCBotEstablished pattern0%0Similar to others
BytespiderEstablished pattern0%0Similar to others
AmazonbotEstablished pattern0%0Similar to others
DuckAssistBotEstablished pattern0%0Similar to others
MistralAI-UserEstablished pattern0%0Similar to others
cohere-aiEstablished pattern0%0Similar to others
YouBotEstablished pattern0%0Similar to others
DiffbotEstablished pattern0%0Similar to others
TimpibotEstablished pattern0%0Similar to others
PetalBotEstablished pattern0%0Similar to others

Figures are rounded and cover only sites that served the file for the whole window. Requests are to Geordy-served files, identified by user agent; a request is not evidence of use or citation. Pairs with too few independent sites are not shown. See how we measure.

Other core formats

Generate every format at once.

Geordy emits 8 formats on every plan and 16 on Growth, auto-selected per page type and live on Geordy the moment they are written.

Schema JSON (JSON-LD) (.json) format - spec, examples and AI readers | Geordy